Vibe交易智能体
经 AI Skill Hub 精选评估，Vibe交易智能体 获评「推荐使用」。已获得 7.2k 颗 GitHub Star，这款AI工具在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 7.8 分，适合有一定技术背景的用户使用。
📚 深度解析
**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。
**安装与环境准备**
Vibe交易智能体 依赖 Python 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 Python 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。
**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 Vibe交易智能体 的版本更新，及时通知重要功能变化。
📋 工具概览
Vibe交易智能体 是一款基于 Python 开发的开源工具，专注于 交易自动化、算法交易、MCP工具 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
📖 中文文档
Vibe交易智能体 是一款基于 Python 开发的开源工具，专注于 交易自动化、算法交易、MCP工具 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
# 方式一：pip 安装（推荐）
pip install vibe-trading
# 方式二：虚拟环境安装（推荐生产环境）
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install vibe-trading
# 方式三：从源码安装（获取最新功能）
git clone https://github.com/HKUDS/Vibe-Trading
cd Vibe-Trading
pip install -e .
# 验证安装
python -c "import vibe_trading; print('安装成功')"
- 访问 GitHub 仓库页面
- 按照 README 文档完成依赖安装
- 根据系统环境完成初始化配置
- 参考官方示例或文档开始使用
- 遇到问题可在 GitHub Issues 中查找解答
# 命令行使用
vibe-trading --help
# 基本用法
vibe-trading input_file -o output_file
# Python 代码中调用
import vibe_trading
# 示例
result = vibe_trading.process("input")
print(result)
# vibe-trading 配置文件示例（config.yml） app: name: "vibe-trading" debug: false log_level: "INFO" # 运行时指定配置文件 vibe-trading --config config.yml # 或通过环境变量配置 export VIBE_TRADING_API_KEY="your-key" export VIBE_TRADING_OUTPUT_DIR="./output"
简介
<p align="center"> <b>English</b> | <a href="README_zh.md">中文</a> | <a href="README_ja.md">日本語</a> | <a href="README_ko.md">한국어</a> | <a href="README_ar.md">العربية</a> </p>
<p align="center"> <img src="assets/icon.png" width="120" alt="Vibe-Trading Logo"/> </p>
Vibe-Trading: Your Personal Trading Agent
<p align="center"> <b>One Command to Empower Your Agent with Comprehensive Trading Capabilities</b> </p>
<p align="center"> <a href="https://trendshift.io/repositories/25527" target="_blank"><img src="https://trendshift.io/api/badge/repositories/25527" alt="HKUDS%2FVibe-Trading | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a> </p>
<p align="center"> <img src="https://img.shields.io/badge/Python-3.11%2B-3776AB?style=flat&logo=python&logoColor=white" alt="Python"> <img src="https://img.shields.io/badge/Backend-FastAPI-009688?style=flat" alt="FastAPI"> <img src="https://img.shields.io/badge/Frontend-React%2019-61DAFB?style=flat&logo=react&logoColor=white" alt="React"> <a href="https://pypi.org/project/vibe-trading-ai/"><img src="https://img.shields.io/pypi/v/vibe-trading-ai?style=flat&logo=pypi&logoColor=white" alt="PyPI"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow?style=flat" alt="License"></a> <br> <a href="https://github.com/HKUDS/.github/blob/main/profile/README.md"><img src="https://img.shields.io/badge/Feishu-Group-E9DBFC?style=flat-square&logo=feishu&logoColor=white" alt="Feishu"></a> <a href="https://github.com/HKUDS/.github/blob/main/profile/README.md"><img src="https://img.shields.io/badge/WeChat-Group-C5EAB4?style=flat-square&logo=wechat&logoColor=white" alt="WeChat"></a> <a href="https://discord.gg/6TdQnT5xcF"><img src="https://img.shields.io/badge/Discord-Join-7289DA?style=flat-square&logo=discord&logoColor=white" alt="Discord"></a> </p>
<p align="center"> <a href="https://vibetrading.wiki/">Website</a> · <a href="https://vibetrading.wiki/docs/">Docs</a> · <a href="#-news">News</a> · <a href="#-key-features">Features</a> · <a href="#-shadow-account">Shadow Account</a> · <a href="#-demo">Demo</a> · <a href="#-quick-start">Quick Start</a> · <a href="#-examples">Examples</a> · <a href="#-api-server">API / MCP</a> · <a href="#-roadmap">Roadmap</a> · <a href="#-contributing">Contributing</a> </p>
<p align="center"> <a href="#-quick-start"><img src="assets/pip-install.svg" height="45" alt="pip install vibe-trading-ai"></a> </p>
---
✨ Key Features
 🔍 Self-Improving Trading Agent
• Natural-language market research
• Strategy drafts and file/web analysis • Memory-backed workflows |
 🐝 Multi-Agent Trading Teams
• Investment, quant, crypto, and risk teams
• Streaming progress and persisted reports • Workers grounded with fetched market data |
 📊 Cross-Market Data & Backtesting
• A/HK/US equities, crypto, futures, and forex
• Data fallback and composite backtests • PIT data, validation, and run cards |
 👥 Shadow Account
• Broker-journal behavior diagnostics
• Rule-based Shadow Account comparisons • Exportable audit reports and strategy code |
⚡ Quick Example
```bash pip install vibe-trading-ai
🧪 Research Workflow
Most runs follow the same evidence path: route the request, load the right market context, execute tools, validate outputs, and keep the artifacts inspectable.
| Layer | What happens |
|---|---|
| **Plan** | Selects the relevant finance skills, tools, data sources, and swarm preset when useful. |
| **Ground** | Pulls A-shares, HK/US equities, crypto, futures, forex, documents, or web context through the available loaders. |
| **Execute** | Generates testable strategy code, runs tools, and uses the matching backtest engine or analysis workflow. |
| **Validate** | Adds metrics, benchmark comparison, Monte Carlo, Bootstrap, Walk-Forward, run cards, and warnings where applicable. |
Vibe-Trading 是您的个人交易智能体（Trading Agent）。通过简单的指令，即可赋予 Agent 强大的市场分析与策略执行能力，让复杂的金融研究变得触手可及。
本项目具备自我进化的交易智能体能力，支持通过自然语言进行市场研究、策略草拟及文件生成。内置强大的 Finance Skill Library，包含 8 个类别、共 77 项专业金融技能，覆盖从传统市场到 Crypto 及 DeFi 的全方位能力。
运行本项目需要准备好支持的 LLM API key，或者使用 Ollama 进行本地部署。若选择本地安装（Path B），需确保 Python 版本为 3.11+；若选择 Docker 部署（Path A），则需安装 Docker 环境。此外，也支持通过 ChatGPT OAuth 使用 OpenAI Codex。
提供多种安装方式：1. 通过 PyPI 一键安装：`pip install vibe-trading-ai`；2. Docker 部署（零配置）：克隆仓库并使用 `docker compose up --build`；3. 本地源码安装：克隆仓库后创建 `.venv` 虚拟环境并执行 `pip install -e .`。
安装完成后，您可以使用 `vibe-trading` 命令启动交互式 TUI 界面进行任务。也可以通过 `vibe-trading run -p "任务描述"` 执行非交互式指令（如回测策略）。系统支持记忆您的偏好，例如通过指令设定风险控制参数，实现个性化交易体验。
项目通过 `agent/.env` 文件进行配置。您需要根据需求取消注释对应的 LLM provider 并设置相应的 API key。若使用 Docker 部署，后端默认运行在 `127.0.0.1:8899`。若需在公网暴露 API，请务必设置强密码级的 `API_AUTH_KEY` 以确保安全。
本项目提供灵活的接口调用方式。支持通过 `vibe-trading serve --port 8899` 启动 API 服务器。交互式 TUI 具备原生终端渲染能力，支持 Markdown 和表格展示；而对于脚本化调用，可通过 `--json` 参数获取结构化输出。
系统采用严谨的研究工作流：首先进行 Plan 阶段，智能体根据请求选择相关的 Finance Skills、工具及数据源；随后执行工具并加载市场上下文；最后通过验证输出并生成可供检查的 Artifacts（研究产物），确保每一步决策都有据可查。
融合LLM与量化交易的创新工具，MCP框架设计合理，功能完整，星数高表明认可度好，但交易类应用需谨慎对待。
- 需要让 Claude / Cursor 操作本地工具的 AI 工程师
- 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
- Python 依赖冲突：建议用 venv / uv 隔离环境
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 需要让 Claude / Cursor 操作本地工具的 AI 工程师
- 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
- Python 依赖冲突：建议用 venv / uv 隔离环境
👥 适合人群
🎯 使用场景
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
⚖️ 优点与不足
- +GitHub 7.2k Star，社区高度认可
- +MIT 协议，可免费商用
- +完全开源免费，无授权费用
- +本地部署，数据完全自主可控
- +开发者社区支持，遇问题可查可问
- −安装和初始配置可能需要一定技术基础
- −功能完整性通常不如成熟商业产品
- −技术支持主要依赖开源社区，响应速度不稳定
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。
🔗 相关工具推荐
❓ 常见问题 FAQ
AI Skill Hub 点评：Vibe交易智能体 的核心功能完整，质量良好。对于AI爱好者来说，这是一个值得纳入个人工具库的选择。建议先在非生产环境试用，再逐步推广。
| 原始名称 | Vibe-Trading |
| 原始描述 | 开源MCP工具："Vibe-Trading: Your Personal Trading Agent"。⭐7.2k · Python |
| Topics | 交易自动化算法交易MCP工具量化回测LLM应用 |
| GitHub | https://github.com/HKUDS/Vibe-Trading |
| License | MIT |
| 语言 | Python |
收录时间：2026-05-13 · 更新时间：2026-05-16 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。