Getting started

Vibe-Trading overview

Vibe-Trading is an open-source finance research agent. You ask in plain language; it fetches market data, runs backtests and analysis tools, and answers with figures it can trace back to that data.

What it is

Vibe-Trading connects an agent loop to finance tools: market-data loaders, strategy generation, backtest engines, document readers, trade-journal analysis, persistent memory and multi-agent research teams.

You can reach the same agent from four places:

  • Terminal — vibe-trading opens an interactive session; vibe-trading run -p "…" runs one prompt.
  • Web UI — chat, run history, portfolio, Alpha Zoo, scheduled research and settings in the browser.
  • MCP server — vibe-trading-mcp gives Claude Desktop, Cursor, OpenClaw and other MCP clients the same tools.
  • IM channels — Telegram, Slack, Discord, Feishu/Lark, DingTalk, WeCom, email and more run the same session runtime.

What is in 0.1.19

  • 28 market-data sources behind one call, with a fallback chain per market. Most markets need no API key.
  • 12 backtest engines: China A-shares, global equities, India, Korea, Vietnam, Brazil, Argentina, crypto, China futures, global futures, forex and a composite engine for cross-market portfolios, plus an options portfolio engine.
  • 89 finance skills in 9 categories, and 30 swarm presets for committee-style research.
  • Alpha Zoo: 478 alphas you can benchmark on your own universe with one command.
  • 81 MCP tools for other agents.
  • 19 broker connectors, read-only by default, plus a read-only multi-broker portfolio page.
  • Checked numbers: figures in an answer are checked against the tool data of the session before you see them.
  • A web UI in eleven languages.

Where to start

  1. Quick start — install and run a first task.
  2. Configuration — pick a model provider and set the key.
  3. Research workflow — what happens between your question and the answer.
  4. Troubleshooting — when a run fails or a figure is cut.

Boundaries

Vibe-Trading is built for research, simulation and backtesting. Live trading is opt-in and read-only by default: it runs only through a broker you authorize yourself, inside a mandate whose limits you set, and a kill switch halts it at once. Vibe-Trading holds no funds, runs no execution venue, and is not investment advice.