MCPcopy Create free account
hub / github.com/HKUDS/Vibe-Trading

github.com/HKUDS/Vibe-Trading

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.1.19 ↗ · + Follow · compare 8 versions
30,034 symbols 125,879 edges 2,556 files 12,035 documented · 40% ● updated 46d agov0.1.16 · 2026-09-29★ 34,71511 open issues

Browse by type

⨍ Functions 26,887◇ Types & classes 2,943↳ Endpoints 204
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

English | 中文 | 日本語 | 한국어 | العربية | Español | Bahasa Indonesia

Vibe-Trading Logo

Vibe-Trading:你的个人交易智能体

一条命令,让你的智能体具备完整交易研究能力

Star History: GitHub Trending Trendshift: daily ranking Star History: global star ranking

GitHub 主题星标排名 · 2026 年 11 月 4 日

#1 回测  ·  #3 算法交易  ·  #4 量化金融

Python FastAPI React PyPI License

Feishu WeChat Discord

官网  ·  文档  ·  新闻  ·  主要功能  ·  影子账户  ·  演示  ·  快速开始  ·  示例  ·  API / MCP  ·  路线图  ·  贡献者

pip install vibe-trading-ai

📰 新闻

  • 2026-11-05 🚀 v0.1.19 发布(发布说明,pip install -U vibe-trading-ai):研究不再随对话结束而消失——带证据的研究记录可按版本保存并修订,之前轮次和会话中的回测可直接复用,研究目标可原地编辑。新增可选功能:A 股五分钟模拟交易,以及聚源综合问数、智能选股与香农持仓诊断(QVeris 已移除;仅有 GILDATA_TOKEN 不再开启任何功能)。另有阿根廷(BYMA)回测、Parallel 网页搜索、Codex OAuth 模型发现,并修复了 0.1.18 的两个回归问题。共 116 个合并的 PR,另有 21 个经维护者提交合入,来自 26 位贡献者(CHANGELOG)。 今日修复: 回测报告其实际评估的基准;多空组合也能生成风险透视(risk x-ray);GTJA alpha 17 在输入预热期间保持缺失;香农面板支持全部 11 种界面语言;另合入两项已审阅但尚未落地的贡献者修复(#2042 TTM 求和不再跨越缺失季度,#1985 3:2 拆股识别)。感谢 @rudycelekli, @he-yufeng, @Jackzigen, @Shizoqua, @cgycorey, @dajiaohuang, @zeus229, @alexwan02, @BHhhh-123, @remote-controlled-man, @shadowinlife, @TWJxi, @lishuanghong1989-netizen, @TerryF7, @davidalmeida90, @DrDLyuan, @goatyyc, @hnq-ai, @kadyrbekovhamit-cyber, @MetaAviator, @octo-patch, @RowanAldean, @VectorPeak, @wavebyrd 和 @yufengsika!

  • 2026-11-04 📊 聚源综合问数、智能选股与香农持仓诊断 — 可以一次查出市值前三的股票及其半年营收,也可以查看组合的十因子风格暴露和各持仓对波动的贡献。聚源九项功能默认全关,已有 Token 也需逐项开启。免费数据源查不到时不会自动转用聚源。 #2117 · #2118 · #2119 同日明确了回测信号在下一根 K 线开盘成交的约定,修复了特殊换行符导致 Swarm 任务被误判为超时的问题,并加快了研究资料查重。 #2137 · #2155 · #2159

  • 2026-11-03 🛠️ 运行完整性与本地化后续修复:trace、审计账本和会话搜索的 JSONL 保留 U+2028/U+2029,含这些字符的账本记录仍可继续追加;模型名称统一下划线写法;上下文第 2 层压缩保留 handoff 摘要。另支持带 BOM 的 frontmatter,并让欢迎页在 RTL 语言中保持阅读方向。补充回归测试。

更早的新闻

  • 2026-11-02 🛠️ frontmatter、结果安全与欢迎页润色:去除带引号的标量元数据外壳;超大结果无法编码时回退到可读截断;调整欢迎页布局和精选示例,并补充回归测试。

  • 2026-11-01 🛠️ 会话时间、主题对比度与欢迎页交互:会话更新统一记录 UTC 时间;深色模式主按钮保持可读;侧栏示例可点击并显示清晰的分类标签。补充回归测试。

  • 2026-10-31 🛠️ 欢迎页与代码解析润色:欢迎页改用暖色纸感和双栏布局,精选示例与侧栏操作更清晰;避免把 ticker 末尾字母误读成 A 股或 A/H 约束。

新闻归档 · 更新日志

✨ 主要功能

🔍 市场研究 · 查行情、读公告,穿透查看 ETF 持仓 · 用 DCF 和同行估值倍数评估公司 · 跟踪财报并定时生成盘前简报🐝 研究团队 · 30 支预设团队,覆盖股票、量化、加密资产和风控 · 对照多空观点,查看风险评审 · 在 Pixel Office 分派研究任务

📊 量化实验室 · 评测五个因子库中的 478 个 Alpha · 跨市场回测,检验样本外表现 · 分析期权损益、希腊字母和组合风险👥 交易与组合 · 19 个券商连接器,可按券商查看权限 · 跟踪模拟成交,为支持的实盘交易设限 · 用影子账户回放自己的交易规则

💡 Vibe-Trading 是什么?

把金融问题变成研究报告、可运行的回测或模拟投资组合。你也可以授权支持的券商在指定限额内执行实盘交易,并随时叫停。资金始终留在券商账户。

✨ 你能做什么

任务 从哪里开始
研究市场和文件 在 Web 对话中提问,或上传报告。
回测策略或比较因子 在 Run Detail 查看图表与成交,或在 /alpha-zoo 比较因子。
模拟交易或复盘 在 /paper-trading 跟踪每日成交与净值,用 CLI 的 /journal 和 /shadow 复盘。
汇总账户或比较配置 在 /portfolio 查看持仓和调整建议。券商支持
分析期权或相关性 在 /options 查看多腿损益和希腊字母,在 /correlation 观察市场状态。
组织或定时运行研究 运行 Swarm 团队,在 Pixel Office 分工,或在 /scheduled 安排简报。
回看研究证据 在 /research-artifacts 搜索带日期的研究版本。

⚡ 快速示例

运行 vibe-trading init 后,可以用自然语言发起回测,也可以从终端评测已有因子库。

vibe-trading run -p "回测 BTC-USDT 在 2024 年的 20/50 均线交叉策略,与买入持有比较,并报告最大回撤。"
vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025 --top 20

打开 Run Detail 对比策略与买入持有,查看回撤期间的成交和运行卡片上的数据源。

🧪 研究流程

步骤 以上述均线策略为例
规划 从问题中确定交易对、日期、均线周期和基准。
取数 获取 BTC-USDT 历史 K 线,核对来源与日期。
执行 编写策略并回测,在运行目录查看策略、成交和净值曲线。
验证 对比买入持有,同时核对收益、换手、回撤和验证提示。
复查 打开已保存的运行或调整参数继续提问。还可保存带日期的结论,获得新证据后修订。

📡 数据源与自动切换

支持 28 个行情数据源。source: "auto" 会根据代码识别市场,按配置顺序尝试数据源。

市场 取数顺序
A 股与港股 先试腾讯,缺少 K 线时尝试东方财富及该市场的后续来源。
美股 依次尝试 Yahoo、Stooq、Sina。
加密资产 先试 OKX、Binance、CCXT,再使用其他来源。
期货 国内合约可用 AKShare 或本地 K 线,海外合约需提供本地数据。

也可指定来源。安装 vibe-trading-ai[ashare] 后可通过 BaoStock 免费获取 A 股日线,无需 Token。数据源参考列出完整顺序与凭证要求。

🔩 详细功能

市场研究

功能 用法
公告与持仓 按季度对比基金经理的 SEC 13F 持仓,或穿透查看 ETF 成分。每份报告标明持仓日期。
公司估值 用 /dcf 调整折现率和永续增长率,用 /comps 比较同行倍数,也可建立三表联动模型并导出 Excel。
论文与文档 在 arXiv、OpenAlex 找信号,核对作者定义,再在自己的标的池检验。上传公告、表格或幻灯片后可就某张图表提问。
选股 启用聚源后,一次即可按市值筛选并取得半年营收。选股与组合因子诊断需分别启用。

量化研究

功能 用法
Alpha Zoo 评测 Qlib、Alpha101、GTJA、学术与基本面因子,比较不同期限的 IC,并用滚动样本外检验复核。
回测引擎 模拟 A 股涨跌停、加密资产资金费率与期货保证金,跨市场共享资金池并逐笔检查成交。
期权实验室 逐腿构建价差,查看到期损益、希腊字母以及现货价格与隐含波动率变化的影响。
组合风险 查看回撤、VaR 和预期损失,用 Brinson 区分配置与选股贡献,并观察市场相关性的变化。
策略跟踪 登记策略及证据,跟踪后续结果中的夏普比率和因子 IC。

账户与交易

功能 用法
投资组合 汇总券商只读持仓快照或导入 extraETF 文件,输入目标权重预览各持仓的金额变化。
模拟交易 已保存账户可逐个交易日推进,查看成交、现金和净值。还可在独立模拟中按五分钟回放 A 股交易日。
影子账户 导入券商成交记录,检查费用和交易习惯,对照按规则回放与实际成交。
券商连接 通过 CLI 或 Web 配置连接并测试读取。支持实盘的配置须先设定标的、订单和敞口限额,可一键停止实盘。

团队与定时研究

功能 用法
Swarm 与 Pixel Office 运行多空投委会或量化研究团队,查看成员报告。在 Pixel Office 分派任务,将结果记到共享看板。
定时简报 选择盘前简报、财报跟踪或组合体检,设定时间后发送至已配置的 Slack、Telegram 或邮箱。
研究历史 搜索旧会话并重新打开运行。保存带证据和日期的结论,投资逻辑变化时对照各次修订。
运行记录 核对回测的数据源、模型、执行记录和指标依据,重新打开成交与净值曲线验证报告中的数字。

券商支持一览

按券商比较只读、模拟盘和实盘

只读为专用只读配置,模拟盘使用券商沙箱或本地撮合,实盘必须在授权限额内执行。✓ 表示已声明支持,— 表示无对应配置。

券商 只读 模拟 实盘
alpaca ✓ ✓ ✓
binance ✓ ✓ ✓
dhan ✓ ✓ —
etoro ✓ ✓ ✓
futu ✓ ✓ ✓
ibkr ✓ — —
kis ✓ ✓ —
longbridge ✓ ✓ —
mstock ✓ — —
mt5 ✓ ✓ ✓
okx ✓ ✓ ✓
robinhood ✓ — ✓
scalable ✓ — —
shoonya ✓ ✓ —
tiger ✓ ✓ ✓
toss ✓ — —
trading212 ✓ — —
upbit ✓ ✓ —
zerodha ✓ ✓ —

查看各配置的完整权限

🎬 演示

Web · 从提问到回测CLI · 交互终端
https://github.com/user-attachments/assets/2c595ee1-c577-481a-9460-34ea12bcf41c https://github.com/user-attachments/assets/ac79426e-f3f7-4349-b0d5-d997a2725784
输入策略要求,跟踪执行过程并查看回测结果。在终端浏览研究模板,打开盘前简报。

🚀 快速开始

使用 Python 3.11+ 安装,在向导中选择模型服务商,再打开交互终端。

pip install vibe-trading-ai
vibe-trading init
vibe-trading

Docker 将前端和 API 部署在 http://localhost:8899。首次克隆后,先配置模型服务商再启动。

git clone https://github.com/HKUDS/Vibe-Trading.git
cd Vibe-Trading
cp agent/.env.example agent/.env
# 在 agent/.env 中设置服务商和 API 密钥。
docker compose up --build

PyPI 发行包包含 CLI、API 和 MCP 服务。前端开发和本地模型配置见安装指南。

🖥 CLI 命令

运行 vibe-trading 打开终端,输入 /help 浏览命令。

命令 用途
/model 切换当前会话的模型或服务商。
/history 浏览并继续旧对话。
/show <run-id> 查看已保存的运行结果。
/pine 将当前策略导出为 Pine Script 指标。

在 shell 中用 vibe-trading alpha list 浏览因子库,用 vibe-trading playbook list 查看定时研究模板。

💡 示例

  • 比较 AAPL 与 MSFT 在 2024 年的表现,哪个月的收益差距最大?用 /history 继续对话。
  • 用 /journal 分析导出的成交记录,再用 /shadow 比较按规则交易的结果。
  • 选一只股票,跟随投委会的多空辩论直到最终报告。
vibe-trading --swarm-run investment_committee '{"target":"TSLA","market":"US"}'

🌐 API 服务

运行 vibe-trading serve --port 8899。在另一个终端用 curl http://localhost:8899/runs 列出运行,再用返回的 ID 调用 GET /runs/{run_id} 查看结果。

通过 HTTP 运行研究 端点
创建会话 POST /sessions
发送问题 POST /sessions/{id}/messages
接收实时进度 GET /sessions/{id}/events

在 http://localhost:8899/docs 试用接口。需要认证的客户端通过 Authorization: Bearer 发送 API 密钥。

🔌 MCP 插件

MCP 客户端可通过 stdio 启动同一个包。在 Claude Desktop 的 claude_desktop_config.json 中添加以下配置,重启后调用 list_skills。

{
  "mcpServers": {
    "vibe-trading": { "command": "vibe-trading-mcp" }
  }
}

其他客户端和自定义输出目录见 MCP 配置。

🏛 生态项目

Vibe-Trading 是 HKUDS 智能体生态的一部分:

NanoBot Ultra-Lightweight Personal AI Assistant AI-Trader Agent-Native Signal & Copy Trading Platform CLI-Anything Making All Software Agent-Native OpenSpace Self-Evolving AI Agent Skills ClawTeam Agent Swarm Intelligence

🗺 路线图

领域 已发布 计划中
模拟交易 跨会话保存每日现金、成交和净值。独立模拟可按五分钟回放 A 股交易日。 可选的按成交量占比撮合(#2128,草稿)。
研究 运行卡片记录回测指标与证据。带日期

Extension points exported contracts — how you extend this code

browse all types & interfaces →

Core symbols most depended-on inside this repo

browse all functions →

Shape

Function 18,158
Method 8,729
Class 2,665
Interface 278
Route 204

Languages

Python96%
TypeScript4%

Modules by API surface

agent/cli/_legacy.py188 symbols
frontend/src/lib/api.ts164 symbols
agent/tests/test_agent_grounding.py150 symbols
agent/tests/test_shadow_account.py136 symbols
agent/tests/test_grounding_release.py130 symbols
agent/tests/test_institutional_holdings_tool.py126 symbols
agent/mcp_server.py118 symbols
agent/tests/test_strategy_store.py116 symbols
agent/tests/test_mt5_connector.py115 symbols
agent/tests/test_base_engine.py112 symbols
agent/tests/test_sdk_connectors.py108 symbols
agent/tests/test_llm.py105 symbols

Dependencies from manifests, versioned

@electron-internal/extract-zip1.0.4 · 1×
@fontsource/inter5.3.0 · 1×
@fontsource/jetbrains-mono5.3.0 · 1×
@testing-library/react16.3.3 · 1×
@types/node24.10.0 · 1×
@types/react19.3.0 · 1×
@types/react-dom19.3.0 · 1×
@vitejs/plugin-react5.2.0 · 1×
@vitest/coverage-v85.0.5 · 1×

For agents

$ claude mcp add Vibe-Trading \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page