About HKUDS/Vibe-Trading
HKUDS/Vibe-Trading is an open-source project on GitHub, mainly written in Python. "Vibe-Trading: Your Personal Trading Agent" It currently holds 38,359 stars and 6,244 forks with 28 open issues, and was last pushed on 2026-11-16 (repository created 2026-04-01).
Project Overview
Git Homed tracks it on the Today's Trending board, currently at rank #40 with 86 new stars today.
GitHub Repository Details
README
English | 中文 | 日本語 | 한국어 | العربية | Español | Bahasa Indonesia
Vibe-Trading: Your Personal Trading Agent
One Command to Empower Your Agent with Comprehensive Trading Capabilities
GitHub topic rankings by stars · Nov 4, 2026
#1 Backtesting ·
#3 Algorithmic Trading ·
#4 Quantitative Finance
Website · Docs · News · Features · Shadow Account · Demo · Quick Start · Examples · API / MCP · Roadmap · Contributors
📰 News
- 2026-11-15 📡 Unified market-data gateway and ready-to-use CSVs — Historical bars and US option snapshots share a local data gateway with source fallback, shared caching and bounded concurrency. Responses preserve source, currency and price-adjustment metadata, with explicit coverage and freshness information.
YYYY-MM-DD range, the runtime constrains dates before acquisition; calculation warmup is requested separately, and existing indicator/backtest lookbacks remain available. On main, for the next pip release.
- 2026-11-14 🔌 Unified LLM gateway and version checks — Model providers now share one catalog and configuration layer across Agent, CLI, API and Swarm. Client settings stay isolated, native adapters respect explicit proxy settings, and cross-origin redirects are blocked before credentials or request bodies are forwarded.
main, for the next pip release.
- 2026-11-13 🛠️ Research delivery and calculation tools — Research answers stream without automatic numeric redaction, forced rewrites, or format-based completion gates. Interrupted committee runs preserve partial results and can resume unfinished roles while reusing completed work.
options_payoff calculate stock-plus-options strategies and compare multiple alternatives in one call, returning explicit costs, payoff bounds, and comparison directions. Effective backtest fees and truncation/error states remain explicit; live-trading authorization limits remain in place. Unreleased.
Earlier news
- 2026-11-12 🛠️ Backtest timing, report figures and research completion fixes — Shadow Account now uses the requested starting capital; token-truncated worker replies no longer count as completed. Committee PMs can synthesize valid upstream reports without fetching the same data again, and the native Anthropic adapter defaults to a configurable 16,384 output tokens.
- 2026-11-11 🧾 Paper-trade partial fills and ledger reconciliation — Opt into per-order volume caps, partial fills and reported order states for A-share 5-minute paper simulations (#2128). Independently reconcile fees, cash, positions and NAV arithmetic from returned fills with the new
paper_trade_reconcileAgent/MCP tool (#2197).
main, for the next pip release.
- 2026-11-10 📊 Interactive IV surfaces and options analysis fixes — Edit strike/expiry IV grids in Options Lab, with observed/interpolated labels and no extrapolation (#2186).
CF501 now use China futures rules (#2193).
Thanks @he-yufeng and @GPT-AGI! On main, for the next pip release.
- 2026-11-09 🧭 Export a selected revision comparison; backtests refuse codes they cannot place — Download the exact pair of research revisions you are comparing as JSON or Markdown from the Web, API or CLI (#2189). A backtest code no market rule recognises (such as
local:BHP.AXor7203.T) is now refused before any data is fetched instead of running on A-share rules; bare six-digit and.SSShanghai codes still work. OpenRouter replies no longer show the model name twice (#2191), and an empty revision id inresearch-artifact exportis now an error. Thanks @he-yufeng and @Gloubiboulgator! Onmain, for the next pip release. - 2026-11-08 📝 Research revision comparison and full-history export — Compare content, evidence and metadata between any two revisions (#2168), and export the complete research history as JSON or Markdown (#2170). Switching research records now ignores stale responses, and Markdown exports preserve original content in isolated code blocks. Also fix missing factor weights, partial-return attribution, insufficient IC samples, non-finite valuation inputs and margin calculations for negative entry prices. On
main, for the next pip release. - 2026-11-07 🧪 Research Lab: trading costs and out-of-sample testing — Rerun saved price inputs under different fees and slippage; select parameters using training results only, then freeze them for out-of-sample tests and a separate final holdout. The Research Lab shares Web, CLI, API and Agent/MCP workflows, with all eleven UI languages. Also correct window-boundary returns and factor warmup/long-window calculations, and add 20 offline task-replay cases that keep missing evidence visible. Versioned research artifacts can now store structured financial facts (#2164), and bare Chinese futures contract codes resolve correctly (#2177). On
main, for the next pip release. - 2026-11-06 📈 Implied-volatility grids and paper-trading fixes — Build strike-by-expiry IV grids from supplied option observations, with observed/interpolated labels and no extrapolation (#2172). Extreme numeric inputs now produce finite results or explicit errors. A-share 5m market orders blocked by a price limit are canceled immediately (#2176); the matcher also processes symbols chronologically so later proceeds cannot fund earlier orders. On
main, for the next pip release; public 5m requests still support one symbol per step. - 2026-11-05 🚀 v0.1.19 released (Release notes,
pip install -U vibe-trading-ai): research that outlives the chat — save versioned research artifacts with their evidence and revise them, reuse backtests from earlier turns and sessions, and edit a research goal in place. New opt-ins: a five-minute A-share paper simulation, and Gildata financial queries, stock screening and Shannon portfolio diagnosis (QVeris is removed; an existingGILDATA_TOKENalone now enables nothing). Also Argentina (BYMA) backtests, Parallel web search, Codex OAuth model discovery, and both 0.1.18 regressions fixed. 116 merged pull requests plus 21 landed through maintainer commits, from 26 contributors (CHANGELOG).
- 2026-11-04 📊 Gildata financial queries, stock screening and Shannon portfolio diagnosis — Screen stocks by market cap and retrieve their half-year revenue in one request, or inspect portfolio factor exposures and each holding’s contribution to volatility. All nine Gildata features are opt-in, including for existing token holders. Free data sources never fall back to Gildata. #2117 · #2118 · #2119
- 2026-11-03 🛠️ Runtime integrity and localization follow-ups: Preserve U+2028/U+2029 inside trace, audit-ledger and session-search JSONL records, keep ledger appends valid after such payloads, normalize underscored model labels, and preserve handoff summaries during layer-2 compaction. Also accept BOM-prefixed frontmatter and keep the welcome surface aligned in RTL locales. Add regression coverage.
- 2026-11-02 🛠️ Frontmatter, result safety and welcome polish: Unquote quoted scalar metadata, fall back to a readable truncation when an oversized result cannot be encoded, and refine the welcome layout and featured cards. Add regression coverage.
- 2026-11-01 🛠️ Session timestamps, theme contrast and welcome interactions: Stamp session updates in UTC, keep dark-mode primary buttons legible, and make side-panel examples clickable with clear category labels. Add regression coverage.
- 2026-10-31 🛠️ Welcome and ticker parsing polish: Move the welcome surface to a warm paper palette and two-column layout, make featured examples and side-panel actions clearer, and stop trailing ticker letters from being interpreted as A-share or A/H constraints.
✨ Key Features
💡 What Is Vibe-Trading?
Vibe-Trading turns finance questions into research reports, runnable backtests and paper portfolios. You can also authorize a supported broker to execute live trades within a mandate you set and can halt. Your funds stay with the broker.
✨ What You Can Do
| Task | Where to start |
|---|---|
| Research markets, filings or uploaded documents | Ask in Web chat or attach a report. |
| Backtest a strategy or benchmark alphas | Inspect charts and trades in Run Detail, or compare factors in /alpha-zoo. |
| Simulate trading or replay a journal | Track daily fills and NAV in /paper-trading. Use /journal and /shadow in the CLI to review your trades. |
| Combine accounts or compare allocations | Open /portfolio for holdings and proposed allocation changes. Broker support |
| Explore options and correlations | Open /options for multi-leg payoffs and Greeks, or /correlation for market regimes. |
| Coordinate or repeat research | Run a Swarm team, assign work in Pixel Office or schedule a brief in /scheduled. |
| Revisit research with dated evidence | Search /research-artifacts, compare any two revisions, and export a full series or selected comparison as JSON or Markdown. Versioned research |
⚡ Quick Example
Once you have run vibe-trading init, you can ask for a backtest in plain English or benchmark an existing alpha library from the terminal.
vibe-trading run -p "Backtest a BTC-USDT 20/50 moving-average crossover for 2024. Compare it with buy-and-hold and report maximum drawdown."
vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025 --top 20
Open Run Detail to compare the crossover with buy-and-hold, inspect the trades behind a drawdown and check the data source on the run card.
🧪 Research Workflow
| Step | In the crossover example | |---|---| | Plan | Identify the trading pair, date range, moving averages and benchmark from the prompt. | | Ground | Fetch historical bars for BTC-USDT. Check the source and dates before interpreting the result. | | Execute | Write the strategy and run the backtest. The run directory holds the strategy, trades and equity curve. | | Validate | Compare the result with buy-and-hold. Inspect turnover, drawdown and validation warnings alongside return. | | Revisit | Open the saved run or ask a follow-up with different parameters. You can also save a dated research conclusion and revise it when new evidence arrives. |
📡 Data Sources & Smart Fallback
The loader supports 28 market-data sources. With source: "auto", it infers the market from the symbol and tries the configured sources in order.
| Market | How a request is filled | |---|---| | A-shares and Hong Kong | Start with Tencent. If it cannot supply the bars, try Eastmoney and then the remaining sources for that market. | | US equities | Start with Yahoo. Stooq and Sina are the next two sources in the chain. | | Crypto | Try OKX, Binance and CCXT before falling back to other sources. | | Futures | Chinese contracts can use AKShare or local bars. Supply local bars for global contracts. |
You can also choose a source explicitly. For example, installing vibe-trading-ai[ashare] adds the token-free BaoStock loader for daily A-share bars. The data source reference lists the full chains and credential requirements.
🔩 Detailed Capabilities
Market research
| Feature | What you can do |
|---|---|
| Filings and holdings | Compare a manager’s SEC 13F holdings across quarters, or look through an ETF to its underlying positions. Each holdings report carries its reporting date. |
| Company valuation | Use /dcf to see how a valuation changes with the discount rate and terminal growth. Use /comps for peer multiples, or build a linked three-statement model and export the results to Excel. |
| Papers and documents | Search arXiv and OpenAlex for a signal, inspect the authors’ definition, then test it on your own universe. Upload a filing, spreadsheet or slide deck for questions about a specific exhibit. |
| Stock screening | With Gildata enabled, screen companies by market cap and retrieve half-year revenue in one request. Screening and portfolio factor diagnosis each have their own opt-in. |
Quant research
| Feature | What you can do | |---|---| | Alpha Zoo | Benchmark signals from Qlib, Alpha101, GTJA and the academic and fundamental libraries. Compare information coefficients across horizons, then check whether the result survives a walk-forward test. | | Backtest engines | Model A-share price limits, crypto funding or futures margin. Use a shared capital pool for a cross-market strategy and inspect the individual fills behind its returns. | | Options Lab | Build a spread leg by leg. Compare its expiry payoff with the Greeks and see how the position responds to a change in spot price and implied volatility. | | Portfolio risk | Inspect drawdowns, estimate value at risk and expected shortfall, or use Brinson attribution to separate allocation from stock selection. The correlation view shows when markets start moving together. | | Strategy tracking | Register a strategy with its evidence and track how its Sharpe ratio or factor information coefficient changes as new results come in. |
Accounts and trading
| Feature | What you can do |
|---|---|
| Portfolio | Bring read-only broker holdings into one snapshot or import an extraETF export. Enter target weights to preview the value change for each holding. |
| Paper trading | Advance a saved account one trading day and inspect fills, cash and NAV. You can also replay an A-share session in five-minute steps in a separate simulation. The paper_trade_reconcile agent/MCP tool independently checks fees, cash, positions and NAV arithmetic without market or broker access. |
| Shadow Account | Import your broker’s trade journal, inspect fees and trading habits, then compare the actual trades with a rule-based replay. |
| Broker connections | Set up a connection in the CLI or Web and test it with a read. For supported live profiles, set symbol, order and exposure limits before enabling trading. The kill switch halts live activity. |
Teams and recurring research
| Feature | What you can do | |---|---| | Swarm and Pixel Office | Run a bull–bear investment committee or a quant research desk and inspect the workers’ reports. In Pixel Office, assign a task to a teammate and record the result on the shared board. | | Scheduled briefs | Start from a premarket brief, an earnings tracker or a portfolio checkup. Choose a schedul