Vibe-Trading

环境要求

• Python 环境（README 使用 python -m venv 创建虚拟环境）
• pip（用于安装 PyPI 包 vibe-trading-ai）
• 可选：Git 与 Docker（走源码 / 容器路径时需要）
• 可选：GitHub Copilot 凭据（COPILOT_GITHUB_TOKEN / GH_TOKEN / GITHUB_TOKEN）

安装与启动步骤

1. 1安装命令行工具

   通过 PyPI 安装 vibe-trading-ai，安装后同时获得 vibe-trading、serve 与 mcp 三个命令。

   pip install vibe-trading-ai

   复制

2. 2初始化配置

   执行交互式 .env 配置向导，按提示填入模型与凭据信息，生成运行所需环境文件。

   vibe-trading init

   复制

3. 3运行首个任务

   用 run -p 提交一个自然语言任务，示例为 BTC-USDT 双均线回测并汇总收益与回撤。

   vibe-trading run -p "Backtest a BTC-USDT 20/50 moving-average strategy for 2024 and summarize return and drawdown"

   复制

4. 4启动 Web 界面

   以 FastAPI 服务方式启动 Web UI，README 示例端口为 8899，可自行改用其他端口。

   vibe-trading serve --port 8899

   复制

5. 5启动 MCP 服务

   以 stdio 方式启动 MCP 服务，供 Claude Desktop、OpenClaw、Cursor 等客户端接入。

   vibe-trading-mcp

   复制

6. 6源码或容器部署

   克隆仓库后复制环境模板；Docker 路径为零配置方式，本地路径还需自行创建虚拟环境（README 此处被截断）。

   git clone https://github.com/HKUDS/Vibe-Trading.git
   cd Vibe-Trading
   cp agent/.env.example agent/.env
   python -m venv .venv

   复制

7. 7接入外部 MCP

   在 ~/.vibe-trading/agent.json 中声明外部 MCP 服务器，其工具会自动注入智能体注册表。

关键配置

如何确认成功

执行 vibe-trading，其 preflight 会报告 SDK 能否成功认证；执行 vibe-trading serve --port 8899 可确认 Web UI 是否正常拉起。

常见问题

注意事项

• README 的本地安装（Path B）段落被截断，虚拟环境激活与依赖安装命令未给出，需以仓库最新文档为准。
• 认证优先级为：COPILOT_GITHUB_TOKEN > GH_TOKEN > GITHUB_TOKEN > 已存储的 Copilot CLI 凭据 > gh 凭据。
• README 示例中的 GitHub 凭据值 gho_xxx 仅为占位示例，请替换为真实令牌。
• 本项目涉及交易与回测，README 未给出任何收益承诺，请自行评估风险。