QuantHatch

QuantHatch 是一个 AI 交易 Agent 平台，包含前端 Web 应用与后端 API/任务系统。
用户可以创建、配置、运行交易 Agent，并查看信号、持仓、执行记录与绩效。

主要能力

• Agent 创建向导（市场、工具、模型、Skill、发布）
• Agent 运行与多轮工具调用（含运行记录与 SSE 流式事件）
• 信号生成、组合持仓、绩效统计与排行榜
• 用户认证、订阅、钱包、兑换码
• 平台状态页与基础运维可观测能力

技术栈

• 前端：Next.js 16、React 19、TypeScript、Tailwind
• 后端：FastAPI、SQLAlchemy、PostgreSQL、Redis、Celery
• 数据迁移：Alembic

仓库结构

.
├── backend/                # FastAPI + Celery + Alembic
│   ├── app/                # 业务代码
│   ├── migrations/         # 数据库迁移
│   ├── scripts/            # 开发/运维脚本
│   └── docker-compose.yml  # 本地后端依赖编排
├── quanthatch/             # Next.js 前端
├── docs/                   # 详细设计与说明文档
└── scripts/                # 根目录辅助脚本

快速开始

1) 后端（Docker 推荐）

cd backend
cp .env.example .env
docker compose up -d

后端健康检查：

curl http://localhost:5003/health

2) 前端

cd quanthatch
npm install
npm run dev

默认访问：

• 前端：http://localhost:3000
• 后端 API：http://localhost:5003

环境变量

后端示例见 backend/.env.example。

关键项：

• DATABASE_URL
• REDIS_URL
• JWT_SECRET_KEY
• OPENAI_API_KEY / QWEN_API_KEY / DEEPSEEK_API_KEY 等模型密钥
• QVERIS_API_KEY（如启用 qveris 数据源）

前端可通过 NEXT_PUBLIC_API_URL 指向后端 API。

常用开发命令

前端：

cd quanthatch
npm run lint
npx tsc --noEmit
npm run build -- --webpack

后端（本地 Python 环境）：

cd backend
python3 -m compileall -q app workers scripts

安全与开源注意事项

• 不要提交任何 .env、私钥、生产凭据。
• 本仓库通过环境变量注入数据库与服务凭据，禁止在代码中硬编码。
• backend/results/ 为运行产物目录，已加入忽略规则，不应进入版本库。
• 发布前建议再次执行密钥扫描（如 gitleaks/trufflehog）并人工复核配置文件。

免责声明

本项目仅用于技术研究与学习，不构成任何投资建议。