LaunchedEditorial Listing

Vibe-Trading

HKUDS (Data Intelligence Lab@HKU) · Vibe-Trading: Open-Source AI Agent for Market Research, Backtesting, and Broker-Connected Trading

Open Vibe-Trading

Vibe-Trading is an open-source (MIT) finance research agent that turns natural-language questions into market data pulls, strategy code, backtests, multi-agent research reports, and trade-journal reviews, with optional broker connectors on which live trading is opt-in, read-only by default, and capped by limits you set. It suits self-directed quant researchers and technical investors who are comfortable running a Python or Docker app with their own LLM key.

PricingFree
Setupmedium
Runs onSelf-hosted
APIYes
Open sourceYes
DocsYes
CategoryFinance
Trading ResearchBacktestingMulti-AgentOpen SourceSelf-HostedModel-AgnosticMCPPythonCLICryptoStock TradingPersistent Memory

Best for

Self-directed quant researchers, students, and technical retail investors who want a free, self-hosted agent that pulls multi-market data, writes and backtests strategies, runs multi-agent research teams, and audits their own trade history, using their own LLM key

Not ideal for

Anyone looking for investment advice or a hands-off money-making bot, non-technical users who do not want to run Python or Docker, and traders who need verified, production-grade live execution or a broker that the connectors keep read-only

Who it's for

Quant researchers, students, and technically minded retail investors who want an open-source agent for multi-market research, backtesting, and trade-journal analysis

Capabilities

  • Natural-language research and backtesting: one prompt can fetch data, generate strategy code, run the matching backtest engine, and return metrics, a run card, and a report
  • Market-specific backtest engines for A-shares, US/HK/Canada/UK, India, Korea, Vietnam, crypto spot and USD-M perpetuals, China and global futures, and forex, plus a cross-market composite with one capital pool and an options-portfolio engine
  • 28 market-data sources with per-market fallback chains, including free keyless sources (Yahoo/yfinance, OKX, mootdx, AKShare) and optional keyed ones such as Tushare, Finnhub, FMP, and QVeris, plus your own CSV, Parquet, or DuckDB files
  • 30 preset multi-agent swarm teams, such as an investment committee (bull/bear debate, risk review, PM call), a quant strategy desk, and a crypto trading desk, with custom presets in YAML
  • Alpha Zoo of 462 pre-built factors (Qlib Alpha158, Kakushadze 101, GTJA 191, academic, and point-in-time SEC fundamentals) with one-command IC and IR benchmarking
  • Validation tools (Monte Carlo, bootstrap, walk-forward), five portfolio optimizers, and run cards with hashed backtest execution records
  • Shadow Account: parses broker trade exports, profiles behavior such as overtrading and the disposition effect, extracts your implicit rules, and backtests them against your actual trades
  • Valuation and research commands (/dcf, /comps, /attrib, /memo, /earnings, /screen) and a quant library of 306 tested functions callable from every interface
  • Persistent memory, full-text session search, editable skills, research goals, and scheduled research jobs delivered to IM channels or email
  • MCP server with 76 tools for Claude Desktop, Cursor, OpenClaw, and other clients, and MCP client mode for loading tools from your own MCP servers
  • 18 broker connectors with read, paper, and mandate-bounded live profiles, a /halt kill switch, an audit ledger, and a read-only multi-broker portfolio page
  • Exports strategies and indicators to TradingView Pine Script, TDX, and MetaTrader 5

Limitations

  • The project states it is not investment advice and that past performance does not guarantee future results; backtests and agent reports are research outputs, not trading recommendations
  • The disclaimer describes broker trading as experimental and not verified by the project against a real broker account, so live use is at your own risk
  • Live order placement is limited: IBKR, Scalable Capital, Trading 212, and Toss Securities are read-only, Longbridge, Dhan, Shoonya, Zerodha, Upbit, and KIS are capped at paper orders, and Robinhood options orders are not supported
  • Self-hosted only: no hosted service is documented, so you need Python 3.11+ or Docker, an LLM provider key or local Ollama model, and must set an API auth key before exposing the server beyond your own machine
  • Results depend on the model: the project warns that small or distilled models call tools unreliably and may answer from training data instead of running backtests
  • Generated backtest code runs as a local Python subprocess, and the security policy asks you to treat generated strategies as code you review before running
  • No prebuilt desktop installer is published; the Electron desktop shell is labeled an unofficial community build and is documented for building from source on Windows
  • Some markets are data-only for now: Argentine (BYMA) backtests deliberately fail until local execution rules are modeled
  • Very frequent releases regularly fix metric and factor calculations, so results can change between versions

Use cases

  • Backtesting a moving-average or RSI strategy on BTC-USDT, US equities, or A-shares from a single natural-language prompt
  • Running an investment-committee swarm on a stock to get bull, bear, and risk views before a decision
  • Benchmarking the GTJA 191 or Alpha101 factor set on the CSI 300 over several years
  • Uploading a broker trade export to see behavioral patterns and how a rule-based version of your own trading would have done
  • Scheduling a pre-market brief or portfolio check-up that is delivered to Telegram, Feishu, or email
  • Giving Claude Desktop or Cursor finance research and backtest tools through the MCP server

Our take

Vibe-Trading is less a single trading bot than a full research bench that an LLM drives: data routing across many markets, market-aware backtest engines, factor benchmarking, and a strict stance on not inventing numbers or inputs. That makes it a strong fit for people who want to test ideas quickly and inspect how each figure was produced. The tradeoffs are breadth and pace. There is a lot to configure, the changelog shows a steady stream of calculation fixes, and live trading is opt-in, capped, and explicitly experimental. Treat it as a research and paper-trading tool, pin versions when results matter, and keep any live mandate tightly capped if you enable one.

Who should use it

Quant-curious developers and students who want to backtest ideas across A-shares, US, HK, crypto, and other markets without writing the plumbing, researchers who want multi-agent reviews and factor benchmarks with traceable outputs, and active traders who want a rule-based audit of their own trade history.

Who should skip it

People who want investment advice or a turnkey bot that trades for them, users who will not manage Python, Docker, or API keys, and anyone who needs verified, production-grade live execution or support for a broker that the connectors keep read-only.

Strengths

  • Free and open source under the MIT license, with any of about 20 LLM providers or a local Ollama model
  • Broad market coverage with keyless data sources and market-specific backtest engines
  • Many interfaces: CLI, web UI, REST API, IM channels, and an MCP server
  • Shadow Account and Alpha Zoo go beyond chat into auditable, reproducible research
  • Conservative trading defaults: read-only or paper first, mandate caps, kill switch, and no order tools over MCP

Weaknesses

  • Self-hosted setup with your own LLM key and optional paid data feeds
  • Live broker trading is experimental and unavailable on many connectors
  • Very large surface area and near-daily changes to learn and keep up with
  • No prebuilt desktop installer

Vibe-Trading pricing

Open source

Free

  • MIT license
  • Install from PyPI, from source, or with Docker
  • CLI, web UI, REST API, IM channels, and MCP server
  • Bring your own LLM provider or local Ollama model

Free tier limits: All features are free. Free market-data sources (Yahoo/yfinance, OKX, mootdx, AKShare, CCXT) work without API keys.

Note: No hosted or paid plan is documented. Costs come from the LLM provider you connect (no API key for a local Ollama model; GitHub Copilot uses an active Copilot subscription, and OpenAI Codex uses a ChatGPT sign-in instead of an OpenAI API key) and from optional data providers such as Tushare, Finnhub, FMP, Tiingo, Alpha Vantage, or QVeris credits. Broker fees are set by your broker.

Technical specs

API pricing

Free local REST API (`vibe-trading serve`); LLM usage is billed by your chosen provider

Available models

DeepSeek V4 Pro via OpenRouter (default in the example config)OpenAIAnthropic ClaudeGoogle GeminiDeepSeekQwenKimiGLMMiniMaxGitHub Copilot modelsOpenAI Codex via ChatGPT sign-inLocal models via Ollama

Where Vibe-Trading excels

Testing a strategy idea across markets

A single prompt fetches data with automatic source fallback, writes the strategy, runs it on the engine that models that market's trading rules, and returns metrics with validation checks, so an idea can be checked in minutes instead of building a pipeline.

Auditing your own trading behavior

Shadow Account parses a broker export, profiles habits such as early exits and overtrading, extracts the rules you actually follow, and backtests them against your real trades in an HTML or PDF report.

Adding finance tools to an existing agent

The MCP server gives Claude Desktop, Cursor, or OpenClaw market data, backtesting, factor analysis, and swarm tools, while order placement stays off MCP.

Vibe-Trading vs. competitors

Vibe-Trading vs. TradingAgents

TradingAgents (Apache-2.0) is a LangGraph framework where analyst, bull and bear researcher, trader, and risk agents debate one ticker's decision, scored with grid backtests and sent to a simulated exchange, with no live brokerage documented. Vibe-Trading (MIT) is a wider end-user workspace: market-specific backtest engines, multi-source data loaders with fallback, a factor library, many swarm presets, trade-journal analysis, scheduled research, a web UI and MCP server, and broker connectors that default to read-only or paper. TradingAgents fits people studying or extending one multi-agent decision pipeline; Vibe-Trading fits people who want a day-to-day research and backtesting bench.

Frequently asked questions

What is Vibe-Trading?

Vibe-Trading is an open-source finance research agent from the HKUDS GitHub organization. You ask questions in natural language and it fetches market data, writes and backtests strategy code, runs multi-agent research teams, analyzes your trade history, and returns reports and run cards. It runs on your own machine through a CLI, web UI, REST API, IM channels, or an MCP server.

Is Vibe-Trading free?

Yes. The code is MIT-licensed and installs from PyPI as `vibe-trading-ai`. Your costs are the LLM you connect and any optional paid data source, such as a Tushare token or QVeris credits. A local model through Ollama needs no API key, an active GitHub Copilot subscription can replace a separately billed API key, and OpenAI Codex can be used through a ChatGPT sign-in. No hosted plan is documented.

Can Vibe-Trading place real trades?

Only if you set it up to. Live trading is opt-in and read-only by default. Most broker connectors offer read access and paper orders, and some are read-only. Live order placement exists for a subset of brokers, such as Alpaca, Tiger, Futu, OKX, Binance, eToro, MetaTrader 5, and Robinhood, and runs only inside a mandate you define, with an instant kill switch. Order-placing tools are not exposed over MCP. The project calls broker trading experimental and not verified against a real broker account.

Which LLMs does Vibe-Trading support?

The README lists OpenRouter, OpenAI, Anthropic, DeepSeek, OpenCode, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, SiliconFlow, Xiaomi MIMO, Novita AI, iFlytek Spark, Z.ai, NVIDIA NIM, ModelScope, GitHub Copilot, and local models through Ollama, plus OpenAI Codex through ChatGPT sign-in. The example config defaults to DeepSeek V4 Pro through OpenRouter.

Does Vibe-Trading work with Robinhood?

Yes, as an external agent through Robinhood Agentic Trading, Robinhood's remote MCP, with desktop OAuth. You can use it as a read-only portfolio source, or opt into a live profile for equity orders within a mandate you set; options orders are not supported and there is no Robinhood paper account. This is separate from Robinhood Agents, the agent built into the Robinhood app itself.

Vibe-Trading vs TradingAgents: what is the difference?

TradingAgents is a Python framework where a fixed team of analyst, researcher, trader, and risk agents debates a decision on one ticker and sends approved orders to a simulated exchange. Vibe-Trading is a broader research workspace: data loaders and backtest engines across many markets, a factor library, 30 swarm presets, trade-journal analysis, scheduled research, and broker connectors, used through a CLI, web UI, API, or MCP.

Integrations & fit

MCPClaude DesktopCursorOpenClawOpenRouterOpenAIAnthropicDeepSeekGeminiOllamaGitHub CopilotYahoo FinanceOKXBinanceCCXTAKShareTushareSEC EDGARInteractive BrokersRobinhoodAlpacaFutuTigereToroMetaTrader 5ZerodhaTradingViewTelegramSlackDiscordFeishuDingTalkMicrosoft TeamsEmailDockerREST API
Good fit forSolo / individual, Startup / small team
Pricing modelFree· No cost to start
See pricing on Vibe-Trading →

Alternatives to consider

About Vibe-Trading

Vibe-Trading is a self-hosted research workspace published under the HKUDS GitHub organization, whose profile names it the Data Intelligence Lab@HKU. You install it from PyPI (`pip install vibe-trading-ai`), from source, or with Docker, then work through an interactive terminal UI, single-shot CLI runs, a local React web UI served by a FastAPI backend, a REST API, IM channels such as Telegram, Slack, Discord, Feishu, and email, or an MCP server that exposes 76 tools to Claude Desktop, Cursor, OpenClaw, and other MCP clients. A request is routed to the relevant finance skills (90 ship with it) and data sources, grounded in fetched market data, executed as generated strategy code or analysis tools, validated with metrics, benchmark comparison, Monte Carlo, bootstrap, and walk-forward checks, and delivered as a report, run card, or Pine Script, TDX, or MetaTrader 5 export. Market coverage spans A-shares, Hong Kong, US, Canadian, UK, Indian, Korean, and Vietnamese equities, crypto spot and perpetuals, futures, and forex, through 28 market-data sources with automatic fallback, and the free sources need no API keys. Backtests run on market-specific engines that model rules such as A-share T+1 and price limits, Indian circuit bands, and crypto funding, plus a cross-market composite and an options-portfolio engine. Beyond single-agent chat it offers 30 preset multi-agent teams (an investment committee, a quant desk, a crypto desk, a risk committee), a 462-factor Alpha Zoo you can bench on your own universe, a tested quant library, DCF and comps models that refuse to run on missing inputs, persistent memory with cross-session search, scheduled research jobs, and a Shadow Account that parses your broker exports, extracts your implicit trading rules, and backtests them against what you actually did. Eighteen broker connectors cover IBKR, Robinhood, Alpaca, Tiger, Futu, OKX, Binance, eToro, MetaTrader 5, KIS, Zerodha, and others. Most offer read access and paper orders; live order placement exists only on some of them and only inside a mandate you set (symbol allowlist, order-size, exposure, and daily trade caps) with an instant kill switch, and order-placing tools are never exposed over MCP. The project says it is research software, not investment advice, that its broker-trading capability is experimental and has not been verified by the project against a real broker account, and that past performance does not guarantee future results. It is free to use; you pay your own LLM provider (or run a local model through Ollama) and any paid data feeds. The repository had about 34.8k GitHub stars on October 5, 2026, and ships near-daily changes, including frequent fixes to metric and factor calculations.

Updates from Vibe-Trading

New FeatureVibe-Trading v0.1.16 adds four broker connectors and stricter number grounding

v0.1.16 added KIS, Upbit, Toss Securities, and Scalable Capital connectors, Argentine (BYMA) market data, weekly and monthly bars, and Email and WebSocket channels. The answer-grounding gate now checks each declared figure against the session's tool evidence and cuts figures that fail instead of refusing the whole answer.

New FeatureVibe-Trading v0.1.15 adds UK equities, Zerodha, and a multi-broker portfolio

v0.1.15 added the UK equity market, a Zerodha Kite Connect connector capped at paper and read-only, and a read-only portfolio view that aggregates holdings across connected brokers. Factors now propagate missing inputs instead of filling them with plausible defaults.

New FeatureVibe-Trading v0.1.13 adds a quant library and valuation engine

v0.1.13 added a tested quant library reachable from the CLI, web UI, REST API, and MCP, plus DCF, comps, and three-statement models that refuse to run when an input is missing.

Are you the founder? Claim this listing →