入门

快速开始

三条命令就能在终端里用上智能体。Web 界面还要多一步，因为 PyPI 包里不含构建好的前端。

安装

需要 Python 3.11 或更高版本，以及一个模型服务商的 API key（本地 Ollama 模型不需要 key）。

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

vibe-trading init 会依次询问服务商、模型、key，以及可选的 Tushare token，写入 ~/.vibe-trading/.env。之后 vibe-trading 打开交互终端，输入 /help 查看命令列表。

第一次运行

在交互会话里直接提问，或者执行一条指令后退出：

vibe-trading run -p "回测 BTC-USDT 2024 年 20/50 均线策略，总结收益和回撤"

智能体会取 K 线、写策略、跑回测，再用回测指标作答。这次运行的代码、成交和指标都留在本地磁盘；vibe-trading --list 可以查看历史运行。

打开 Web 界面

用 Docker——本机不需要装 Python 或 Node：

git clone https://github.com/HKUDS/Vibe-Trading.git
cd Vibe-Trading
cp agent/.env.example agent/.env   # 取消注释你的服务商，填入 key
docker compose up --build

然后打开 http://127.0.0.1:8899。记忆、会话、运行记录和连接器配置都存在 Docker 卷里，git pull && docker compose up --build 之后仍然保留。

从源码运行——需要 Node.js 22.22 或更高版本：

git clone https://github.com/HKUDS/Vibe-Trading.git
cd Vibe-Trading
pip install -e .
vibe-trading setup                 # 安装依赖并构建前端
vibe-trading serve --port 8899

只用 pip install 安装时，vibe-trading serve 只启动 API，并提示 No frontend build found。这是正常的；要用浏览器界面，请走上面两种方式之一。

升级

pip install -U vibe-trading-ai
vibe-trading --version

vibe-trading update 会检查 PyPI 并替你安装最新版本。如果从 0.1.10 之前的版本升级后导入报错，请重建虚拟环境，或执行 pip install --force-reinstall vibe-trading-ai。

在其他智能体里使用

同一个包还会安装 vibe-trading-mcp，这是一个 stdio 模式的 MCP 服务。客户端配置见 MCP 服务。