# ai-trading

**Repository Path**: chen-lexiang/ai-trading

## Basic Information

- **Project Name**: ai-trading
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-21
- **Last Updated**: 2025-10-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🤖 AI Trading Arena

**多AI模型加密货币交易能力测试平台**

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://python.org)
[![React](https://img.shields.io/badge/react-18.x-blue.svg)](https://react.dev)
[![Docker](https://img.shields.io/badge/docker-ready-brightgreen.svg)](https://docker.com)

> 基于NOF1.AI，让不同的大语言模型在真实市场环境中公平竞技

---

## 📋 项目简介

AI Trading Arena 是一个创新的AI能力测试平台，它让 Claude、GPT、DeepSeek 等多个大语言模型在相同的加密货币市场中进行自动交易，通过实际交易表现来评估AI的决策能力。

**核心理念**：**市场是智能的终极测试**

### ✨ 主要特性

- 🤖 **多AI模型并行运行** - 支持6+个主流大语言模型同时交易
- 📊 **实时数据展示** - WebSocket实时推送价格、交易、持仓数据
- 🧠 **决策过程透明** - 完整记录AI的思考链路和交易理由
- 📈 **专业技术分析** - EMA、MACD、RSI、ATR等多种技术指标
- 💎 **终端风格UI** - 复刻NOF1.AI的黑客美学界面
- 🐳 **容器化部署** - 一键启动，开箱即用
- 🔄 **虚拟交易** - 演示版使用虚拟资金，零风险

---

## 🎯 快速开始

### 前置要求

- Docker 20.10+
- Docker Compose 2.0+
- 至少8GB内存
- 稳定的网络连接

### 一键启动

```bash
# 1. 克隆项目
git clone <repository_url>
cd ai-trading

# 2. 配置环境变量
cp .env.example .env
# 编辑.env文件，填入API密钥

# 3. 启动系统
docker-compose up -d

# 4. 初始化数据库
docker-compose exec backend-api alembic upgrade head
docker-compose exec backend-api python scripts/seed_data.py

# 5. 访问系统
浏览器打开：http://localhost:58080

# ✅ 完成！等待3分钟观察首次AI决策
```

### 查看运行状态

```bash
# 查看所有容器
docker-compose ps

# 查看实时日志
docker-compose logs -f

# 查看AI决策日志
docker-compose logs -f celery-worker
```

---

## 📸 界面预览

### 主页 - 实时交易看板
- 实时价格ticker滚动
- 所有模型的账户价值曲线
- 模型排名和性能对比

### 排行榜页面
- 详细的统计数据
- 多维度对比分析
- 高级分析指标

### 模型详情页
- 单个模型的完整交易历史
- 当前持仓详情
- 性能统计分析

### AI对话记录
- 查看AI的完整思考过程
- 了解决策背后的逻辑
- 学习提示词工程

---

## 🏗️ 技术架构

### 系统架构

```
┌─────────────┐
│   用户浏览器  │
└──────┬──────┘
       │
┌──────▼───────┐      ┌──────────────┐
│    Nginx     │◄─────┤  Frontend    │
│   :58080     │      │  (React)     │
└──────┬───────┘      └──────────────┘
       │
┌──────▼─────────────────────────────┐
│      Backend API (FastAPI)         │
│      + LangChain                   │
│      :58000                        │
└──────┬─────────────────────────────┘
       │
┌──────┼─────────────┬───────────────┐
│      │             │               │
▼      ▼             ▼               ▼
┌─────────┐   ┌──────────┐   ┌──────────┐
│PostgreSQL│   │  Redis   │   │  Celery  │
│ :54321  │   │ :56379   │   │ Workers  │
└─────────┘   └──────────┘   └──────────┘
                     │               │
                     └───────┬───────┘
                             │
                     ┌───────▼────────┐
                     │ Data Collector │
                     │  (OKX数据)     │
                     └────────────────┘
```

### 技术栈

**前端**：
- React 18 + Next.js 14
- TypeScript
- Tailwind CSS
- Zustand（状态管理）
- WebSocket

**后端**：
- FastAPI（Python 3.11+）
- LangChain（AI集成）
- Celery + Redis（任务队列）
- PostgreSQL（数据库）
- pandas-ta（技术指标）

**基础设施**：
- Docker Compose
- Nginx
- OKX API（数据源）

---

## 📁 项目结构

```
ai-trading/
├── docs/                  # 📚 完整文档
│   ├── PRD.md
│   ├── DRD.md
│   ├── TRD.md
│   ├── API.md
│   ├── DATABASE.md
│   ├── DEPLOYMENT.md
│   └── PROJECT_OVERVIEW.md
│
├── backend/               # 🐍 后端服务
│   ├── app/
│   ├── tests/
│   ├── Dockerfile
│   └── requirements.txt
│
├── frontend/              # ⚛️ 前端应用
│   ├── app/
│   ├── components/
│   ├── package.json
│   └── next.config.js
│
├── data-collector/        # 📡 数据采集器
│   ├── collector/
│   ├── Dockerfile
│   └── requirements.txt
│
├── nginx/                 # 🌐 Nginx配置
│   └── nginx.conf
│
├── scripts/               # 🛠️ 工具脚本
│   ├── init_db.sql
│   └── seed_data.py
│
├── log/                   # 📊 原站分析数据
│   ├── nof1-*.json
│   └── *.md
│
├── docker-compose.yml     # 🐳 容器编排
├── .env.example           # 🔧 环境变量模板
└── README.md              # 📖 项目说明（本文件）
```

---

## 🔧 配置说明

### 环境变量

复制模板文件：
```bash
cp .env.example .env
```

必须配置的变量：
```bash
# 数据库
DB_PASSWORD=your_password

# OKX API
OKX_API_KEY=your_key
OKX_SECRET_KEY=your_secret
OKX_PASSPHRASE=your_passphrase
OKX_SIMULATED=true  # 建议先用模拟盘

# AI API Keys（至少配置3个）
ANTHROPIC_API_KEY=sk-ant-xxx
OPENAI_API_KEY=sk-xxx
DEEPSEEK_API_KEY=xxx
```

### 端口配置

| 服务 | 端口 | 说明 |
|------|------|------|
| Nginx | 58080 | 前端访问入口 |
| Backend API | 58000 | API服务（内部） |
| PostgreSQL | 54321 | 数据库（开发） |
| Redis | 56379 | 缓存（开发） |

---

## 📚 详细文档

### 完整文档索引

| 文档 | 内容 |
|------|------|
| [PROJECT_OVERVIEW](./docs/PROJECT_OVERVIEW.md) | 项目全景图、快速开始、技术选型 |
| [PRD](./docs/PRD.md) | 产品功能、业务规则、验收标准 |
| [DRD](./docs/DRD.md) | 系统架构、数据库、API、前端设计 |
| [TRD](./docs/TRD.md) | 技术实现、部署方案、优化策略 |
| [API](./docs/API.md) | REST API、WebSocket接口详细说明 |
| [DATABASE](./docs/DATABASE.md) | 数据库schema、查询示例、维护 |
| [DEPLOYMENT](./docs/DEPLOYMENT.md) | 部署步骤、运维任务、故障排查 |

**推荐阅读顺序**：

```
首次了解 → PROJECT_OVERVIEW.md
         ↓
理解需求 → PRD.md
         ↓
技术设计 → DRD.md + TRD.md
         ↓
开始开发 → API.md + DATABASE.md
         ↓
部署上线 → DEPLOYMENT.md
```

---

## 🤝 参与贡献

### 开发规范

**代码规范**：
- 后端：Black + Flake8
- 前端：ESLint + Prettier
- 提交信息：遵循Conventional Commits

**分支策略**：
- main：生产代码
- develop：开发代码
- feature/*：功能分支

**提交流程**：
```bash
1. Fork项目
2. 创建功能分支
3. 编写代码和测试
4. 提交Pull Request
5. 代码Review
6. 合并到主分支
```

### 提问和反馈

- 📝 提Issue：报告Bug或提需求
- 💬 讨论：技术交流
- 📧 联系：项目维护者

---

## 📊 项目状态

**当前状态**：设计阶段 ✅

**已完成**：
- ✅ 需求分析
- ✅ 原站数据采集和分析
- ✅ 完整文档编写
- ✅ 技术架构设计
- ✅ 数据库设计

**进行中**：
- 🚧 代码开发（即将开始）

**计划中**：
- 📅 Week 1-2: 后端开发
- 📅 Week 3-4: 前端开发
- 📅 Week 5: 测试和优化

---

## 📈 性能目标

| 指标 | 目标值 |
|------|--------|
| API响应时间 | < 200ms |
| WebSocket延迟 | < 500ms |
| 页面加载时间 | < 2s |
| AI调用成功率 | > 90% |
| 系统可用性 | > 95% |

---

## 💰 成本估算

**AI API成本**（3个模型，每天）：
- Claude: ~$7
- GPT-4: ~$14  
- DeepSeek: ~$1
- **合计**: ~$22/天，$660/月

**服务器成本**：
- 云服务器（4C8G）: $30-60/月

**总计**：约$700/月（可通过优化降低）

**节省成本方案**：
- 调整AI调用频率（5分钟或10分钟）
- 只运行2个模型
- 使用便宜的AI模型

---

## ⚠️ 重要提醒

### API密钥安全

**请务必注意**：
- ❌ 不要将API密钥提交到Git
- ❌ 不要在公开场合分享密钥
- ✅ 使用.env文件管理密钥
- ✅ .env文件已在.gitignore中
- ✅ 定期更换密钥

**OKX API权限设置**：
- ✅ 读取（Read）
- ✅ 交易（Trade）- 未来使用
- ❌ 提现（Withdraw）- 永远不要开启！

### 建议使用模拟盘

**强烈建议**：
- 先在OKX模拟盘测试
- 验证系统稳定性
- 观察AI决策质量
- 确认无误后再考虑实盘

---

## 🎓 学习资源

### 原站分析

- 原站地址：https://nof1.ai/
- 数据采集：log/目录下的JSON文件
- 提示词分析：log/PROMPT-ANALYSIS-CN.md
- API分析：log/API-ANALYSIS.md

### 技术文档

- OKX API：https://www.okx.com/docs-v5/zh/
- LangChain：https://python.langchain.com/
- FastAPI：https://fastapi.tiangolo.com/
- React：https://react.dev/
- Celery：https://docs.celeryq.dev/

---

## 🗺️ 路线图

### v0.1.0（MVP - 当前）
- ✅ 完整文档
- 🚧 基础架构搭建
- 🚧 核心功能开发
- 🚧 前端UI实现
- 📅 预计时间：4-5周

### v0.2.0（优化版）
- 性能优化
- UI细节完善
- 更多AI模型
- 回测功能

### v1.0.0（生产版）
- 真实交易集成
- 完整测试覆盖
- 生产环境部署
- 用户文档

---

## 📞 联系方式

- 项目仓库：[待定]
- 演示地址：[待定]
- 问题反馈：GitHub Issues

---

## 📄 许可证

[MIT License](LICENSE)

---

## 🙏 致谢

**灵感来源**：
- [NOF1.AI](https://nof1.ai/) - 原创的AI交易竞技场

**技术支持**：
- LangChain社区
- FastAPI社区
- React社区

---

**⭐ 如果这个项目对你有帮助，请给个Star！**

**🚀 开始你的AI交易之旅！**