HKUDS/Vibe-Trading

▲ 86 stars today★ 38,359⑂ 6,244

"Vibe-Trading: Your Personal Trading Agent"

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

Repository HKUDS/Vibe-Trading · default branch main · size 97955 KB · watchers 177 · source: GitHub REST API and repository README

README

English | 中文 | 日本語 | 한국어 | العربية | Español | Bahasa Indonesia

https://github.com/HKUDS/Vibe-Trading/blob/HEAD/Vibe-Trading Logo

Vibe-Trading: Your Personal Trading Agent

One Command to Empower Your Agent with Comprehensive Trading Capabilities

https://github.com/HKUDS/Vibe-Trading/blob/HEAD/Star History: GitHub Trending https://github.com/HKUDS/Vibe-Trading/blob/HEAD/Trendshift: daily ranking https://github.com/HKUDS/Vibe-Trading/blob/HEAD/Star History: global star ranking

GitHub topic rankings by stars · Nov 4, 2026
#1 Backtesting  ·  #3 Algorithmic Trading  ·  #4 Quantitative Finance

https://github.com/HKUDS/Vibe-Trading/blob/HEAD/Python https://github.com/HKUDS/Vibe-Trading/blob/HEAD/FastAPI https://github.com/HKUDS/Vibe-Trading/blob/HEAD/React https://github.com/HKUDS/Vibe-Trading/blob/HEAD/PyPI https://github.com/HKUDS/Vibe-Trading/blob/HEAD/License
https://github.com/HKUDS/Vibe-Trading/blob/HEAD/Feishu https://github.com/HKUDS/Vibe-Trading/blob/HEAD/WeChat https://github.com/HKUDS/Vibe-Trading/blob/HEAD/Discord

Website  ·  Docs  ·  News  ·  Features  ·  Shadow Account  ·  Demo  ·  Quick Start  ·  Examples  ·  API / MCP  ·  Roadmap  ·  Contributors

https://github.com/HKUDS/Vibe-Trading/blob/HEAD/pip install vibe-trading-ai

📰 News

Agent market-data reads deliver CSVs alongside JSON. For supported requests naming instruments and one explicit 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. Check for new versions from Web settings. Desktop gains support for signed updates with verification and recovery; distribution requires a configured update feed and publisher certificates. On main, for the next pip release. Full market-data references feed shell-free QuantLib calculations, and committee roles share source evidence. Options Lab and 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.
Generated strategies reject detected extra shifts on output targets unless explicitly declared intentional, while indicator lookbacks remain valid. Grounding now accepts supported magnitude spellings and precise observed declarations without weakening evidence checks. SPY/GLD backtests match an independent ledger on all 206/140 fills and total returns. Unreleased.
  • 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_reconcile Agent/MCP tool (#2197).
Correctly handle supported wrapped percentage headers and explicitly quoted document integers while preserving their source labels (#2185, #2192). Also fix strict factor benchmark inputs (#2195) and prevent timed-out channel turns from returning an earlier answer (#2194). Thanks @shadowinlife, @he-yufeng, @Jackzigen and @divya0795! On 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).
Fix low-price presets, quantities, expiry dates, retries, language-switch loading and the 20-leg limit. Bare three-digit Zhengzhou contracts such as 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.AX or 7203.T) is now refused before any data is fetched instead of running on A-share rules; bare six-digit and .SS Shanghai codes still work. OpenRouter replies no longer show the model name twice (#2191), and an empty revision id in research-artifact export is now an error. Thanks @he-yufeng and @Gloubiboulgator! On main, 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 existing GILDATA_TOKEN alone 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).
Fixed today: a backtest reports the benchmark it actually evaluated, long/short books get a risk x-ray, GTJA alpha 17 stays missing while its inputs warm up, the Shannon panel speaks all eleven UI languages, and two reviewed contributor fixes that had not landed are in (#2042 TTM sums across a missing quarter, #1985 3:2 split detection). Thanks @rudycelekli, @he-yufeng, @Jackzigen, @Shizoqua, @cgycorey, @dajiaohuang, @zeus229, @alexwan02, @BHhhh-123, @remote-controlled-man, @shadowinlife, @TWJxi, @lishuanghong1989-netizen, @TerryF7, @davidalmeida90, @DrDLyuan, @goatyyc, @hnq-ai, @kadyrbekovhamit-cyber, @MetaAviator, @octo-patch, @RowanAldean, @VectorPeak, @wavebyrd and @yufengsika! On main after the release (next pip release): backtest benchmarks are bought at the first evaluated open, as the strategy is, instead of from the last warm-up close; excess return no longer includes that move (AAPL 20/60 SMA example: 22.5% → 18.4%).
  • 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
Also clarified next-bar backtest fills, fixed false Swarm timeouts on Unicode heartbeats and sped up research artifact deduplication. #2137 · #2155 · #2159
  • 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.
Full news archive · Changelog

✨ Key Features

https://github.com/HKUDS/Vibe-Trading/blob/HEAD/🔍 Market Research: Explore prices, filings and ETF holdings; Value companies with DCF and peer multiples; Track earnings and schedule a premarket brief.https://github.com/HKUDS/Vibe-Trading/blob/HEAD/🐝 Research Teams: 30 preset teams for equities, quant, crypto and risk; Follow the bull case, bear case and risk review; Assign research tasks in Pixel Office.
https://github.com/HKUDS/Vibe-Trading/blob/HEAD/📊 Quant Lab: Benchmark 478 alphas across five libraries; Backtest across markets and test out of sample; Model options payoffs, Greeks and portfolio risk.https://github.com/HKUDS/Vibe-Trading/blob/HEAD/👥 Trading & Portfolio: 19 broker connectors with per-broker permissions; Track paper fills or set limits for supported live trades; Replay your own trading rules with Shadow Account.

💡 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

GitHub Stars & Activity

38,359Stars
6,244Forks
28Open issues
PythonLanguage

GitHub Popularity

GitHub stars38,359
Forks6,244
Open issues28
Primary languagePython
LicenseMIT
Stars gained today86
Created2026-04-01
Last pushed2026-11-16

Trending History

Daily boardrank #40 · ▲ 86 stars

Related GitHub Projects

1

unslothai / unsloth

Python★ 79,596⑂ 7,427▲ 61 stars
→
2

ManimCommunity / manim

Python★ 42,602⑂ 3,349▲ 83 stars
→
3

davila7 / claude-code-templates

Python★ 33,817⑂ 3,991▲ 174 stars
→
4

PrefectHQ / fastmcp

Python★ 28,571⑂ 2,612▲ 82 stars
→
5

andrewyng / openworker

Python★ 19,367⑂ 2,761▲ 139 stars
→
6

Canner / WrenAI

Python★ 18,296⑂ 2,112▲ 46 stars
→
7

SnailSploit / Claude-Red

Python★ 11,076⑂ 1,507▲ 131 stars
→
8

bojieli / ai-infra-book

Python★ 7,872⑂ 635▲ 127 stars
→

More Trending Repositories