Skip to content

encyc/vibe-trading

Repository files navigation

Vibe Trading

基于大语言模型的多 Agent 协作加密货币量化交易系统。

9f79c5cd18a77d6471f97f785ef30a6d

✨ 核心特性

  • 🤖 12 Agent 协作决策: 4阶段层级协作,从市场分析到交易执行
  • 🎭 智能辩论系统: 看涨/看跌研究员多轮辩论,论点自动提取和量化裁决
  • 🧠 BM25 记忆系统: 从历史交易经验中学习,持续优化
  • 📊 Binance 深度集成: 支持永续合约交易,实时 K线订阅
  • 🎯 Paper Trading: 模拟交易模式,零风险验证策略
  • 🌐 Web 实时监控: 可视化界面实时展示决策过程
  • ⚡ 智能风控: VaR计算、凯利公式、波动率调整

🏗️ 系统架构

系统采用4阶段协作架构:

  1. Phase 1 - 分析师团队: 技术、基本面、新闻、情绪分析(并行执行)
  2. Phase 2 - 研究员团队: 看涨/看跌研究员辩论 → 研究经理裁决
  3. Phase 3 - 风控团队: 激进、中立、保守三视角风险评估
  4. Phase 4 - 决策层: 交易员制定计划 → 投资组合经理最终决策

详见:系统架构文档 | 协作流程详解

🧵 多线程架构

  • 宏观线程: 每小时分析大环境(趋势、情绪、重大事件)
  • On Bar线程: K线触发的3阶段决策流程
  • 事件驱动线程: 实时监控紧急事件,秒级响应

详见:多线程架构详解

📦 安装

cd backend
uv pip install -e .

⚙️ 配置

  1. 复制配置文件:
cp backend/.env.example backend/.env
  1. 配置API密钥(在 .env 文件中):
BINANCE_TESTNET_API_KEY=your_key
BINANCE_TESTNET_API_SECRET=your_secret
  1. 配置LLM(在 backend/src/pi_ai/llm.yaml

🚀 使用

Paper Trading(纸面交易)

PYTHONPATH=backend/src uv run -- vibe-trade start BTCUSDT

实盘交易(仅打印订单)

PYTHONPATH=backend/src uv run -- vibe-trade start BTCUSDT --mode live

Prime Agent 监控模式

PYTHONPATH=backend/src uv run -- vibe-trade prime BTCUSDT

📁 项目结构

vibe-trading/
├── backend/
│   └── src/
│       ├── vibe_trading/       # 主应用
│       │   ├── agents/         # Agent实现
│       │   ├── coordinator/    # 交易协调器
│       │   ├── data_sources/   # 数据源
│       │   ├── threads/        # 线程实现
│       │   ├── tools/          # 交易工具
│       │   ├── prime/          # Prime Agent监控
│       │   └── config/         # 配置
│       ├── pi_ai/              # LLM抽象层
│       ├── pi_agent_core/     # Agent框架
│       └── pi_logger/         # 日志系统
└── docs/                      # 文档

🧪 测试

# 运行所有测试
cd backend
uv run pytest

# 运行特定测试
uv run pytest tests/test_technical_analysis.py

# 运行Web监控
uv run test_historical.py  # 访问 http://localhost:8000

🔧 高级功能

Agent Tools

23个工具按角色分配:

  • 技术分析工具(9个):指标、趋势、支撑阻力、K线形态
  • 基本面工具(5个):资金费率、多空比、持仓量
  • 情绪分析工具(3个):恐惧贪婪指数、新闻情绪
  • 风险数据工具(4个):清算订单、持仓量
  • 市场数据工具(2个):当前价格、24h行情

详见:Agent工具文档 | Agent详解

Trigger机制

可扩展的事件触发系统:

  • 价格Trigger:暴跌、暴涨、突破关键位
  • 风控Trigger:VaR超标、连续亏损、保证金不足
  • 用户可自定义Trigger

双模型架构

  • deep_thinking_model: 复杂推理、工具调用
  • quick_thinking_model: 数据获取、简单分析
  • 模型路由器自动选择合适的模型

📖 详细文档

文档 说明
系统架构 整体架构、组件说明、数据流
Agent详解 12个Agent的功能、工具、协作方式
多线程架构 三线程系统详解
协作流程 阶段间数据传递和消息机制
Agent工具 23个工具的详细说明
风险管理 4层约束系统、风控指标
性能指标 性能测试、优化历史
改进历史 版本历史和未来规划

📚 灵感来源

本项目从以下项目汲取灵感:

⚠️ 免责声明

本系统仅供学习和研究使用。加密货币交易具有高风险,过去的表现不代表未来的收益。使用本系统进行实盘交易的所有风险由使用者自行承担。

📄 许可证

MIT License

Star History

Star History Chart