README.md · justin/ai-trader

# 量化交易机器人

基于新浪财经API和DeepSeek AI的量化交易系统，支持多种技术指标策略和AI辅助决策，提供图形化界面和命令行两种使用方式。

![输入图片说明](%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20251118095132_96_263.png)

## 功能特性

- 🔗 新浪财经API集成
- 🤖 DeepSeek AI技术分析
- 📊 多种技术指标策略
- 🛡️ 完善的风险管理
- 📈 实时数据监控
- 📝 详细的交易日志
- 🖥️ 直观的图形化界面
- 📋 实时价格图表显示
- ⚙️ 可视化配置管理

## 安装依赖

### 命令行版本
```bash
pip install -r requirements.txt
```

### GUI版本
```bash
pip install -r requirements_gui.txt
```

## 配置设置

编辑 `config.json` 文件，填入你的API密钥和交易参数：

```json
{
  "api": {

"deepseek": {
      "api_key": "your_deepseek_api_key_here"
    }
  },
  "trading": {
    "symbol": "600000.SH",
    "amount": 10000
  },
  "strategy": {
    "use_ma_strategy": true,
    "use_rsi_strategy": true,
    "use_macd_strategy": true
  },
  "risk": {
    "max_position_size": 100,
    "stop_loss_percent": 0.02,
    "take_profit_percent": 0.04
  },
  "system": {
    "data_update_interval": 5,
    "deepseek_analysis_interval": 300
  }
}
```

**获取API密钥：**
- DeepSeek API密钥：从[DeepSeek官网](https://www.deepseek.com)获取

## 使用方法

### GUI版本（推荐）

#### 启动GUI应用
```bash
python start_gui.py
```

#### GUI界面功能
1. **实时监控**
   - 实时价格图表显示
   - 交易状态实时更新
   - AI分析结果展示
   - 运行时间和分析次数统计

2. **配置管理**
   - 可视化编辑API配置
   - 交易参数设置
   - 策略选择
   - 风险管理参数调整

3. **日志查看**
   - 实时日志显示
   - 多级别日志过滤
   - 日志刷新功能

4. **交易历史**
   - 交易记录表格显示
   - 详细的交易信息

#### GUI操作流程
1. 启动GUI应用
2. 在"配置管理"选项卡中设置API密钥和交易参数
3. 点击"保存配置"按钮保存设置
4. 在"实时监控"选项卡中点击"启动机器人"按钮开始交易
5. 监控交易状态和图表
6. 需要停止时点击"停止机器人"按钮

### 命令行版本

#### 快速启动
```bash
python start.py
```

#### 直接启动
```bash
python main.py
```

### 安装依赖

**Windows用户：**
```cmd
# 推荐使用虚拟环境
python -m venv venv
venv\Scripts\activate

# GUI版本
pip install -r requirements_gui.txt -i https://mirrors.huaweicloud.com/repository/pypi/simple/

# 命令行版本
pip install -r requirements.txt -i https://mirrors.huaweicloud.com/repository/pypi/simple/
```

**Linux/Mac用户：**
```bash
# GUI版本
pip install -r requirements_gui.txt

# 命令行版本
pip install -r requirements.txt
```

## 安全提醒

⚠️ **重要安全提示**：
- 首次使用请在沙盒环境测试
- 不要在代码中硬编码API密钥
- 合理设置止损止盈参数
- 建议小额资金开始测试
- GUI版本中修改配置后请务必点击"保存配置"按钮
- 定期检查日志文件，监控交易活动

## 项目结构

```
├── src/
│   ├── api/          # API客户端
│   ├── strategy/     # 交易策略
│   ├── data/         # 数据管理
│   ├── risk/         # 风险管理
│   └── utils/        # 工具函数
├── main.py           # 主程序入口
├── start.py          # 启动脚本
├── start_gui.py      # GUI启动脚本
├── gui_app.py        # GUI主应用
├── gui_components.py # GUI组件
├── bot_manager.py    # 机器人管理器
├── config.json       # 配置文件
├── requirements.txt  # 命令行版本依赖包
├── requirements_gui.txt # GUI版本依赖包
└── logs/             # 日志目录
```

## 企业微信群通知 -- 待开发
## 钉钉群通知--待开发

## 免责声明

本项目仅供学习和研究使用，不构成投资建议。使用本系统进行实盘交易的风险由用户自行承担。
开发不易感谢支持
![输入图片说明](%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20251114140444_95_263.jpg)

justin/ai-trader

简介

发行版 (3)

贡献者

语言

近期动态

justin/ai-trader .gitee-modal { width: 500px !important; }

简介

发行版 (3)

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

语言

近期动态

搜索帮助

justin/ai-trader