Blave Agent

Quant Workspace for AI Agents

Build, backtest and trade strategies live with Claude Code or Codex. Free and open source.

English | 繁體中文 | 简体中文 | 日本語 | Español | Português | Tiếng Việt

https://github.com/user-attachments/assets/7b33edb7-9c65-4e19-854a-40295c6e8b74

Quick start · Run it with your computer off

Star the repo if this is useful — and Watch › Releases to get notified of new versions.

What Makes It Different

Claude Code or Codex can write a trading bot. Running it for real is the hard part. In a terminal, every strategy is a folder of scripts and a chat log, and past a handful they are hard to keep track of. Wiring up your own auto-trading means handling scheduling, exchange APIs, position reconciliation, restarts and keys yourself. Blave Agent is that missing part.

Your Strategies in One App, Not Scattered Scripts

Each strategy sits in the sidebar with its backtest, trades, parameter scan, out-of-sample test, code and saved versions. Restore an old version from the list, and set how much each strategy trades on the Portfolio page.

Auto-Trading Already Wired Up

• Connect an exchange: Binance, OKX, Bybit, BingX, Gate.io, or President Futures on Windows. The key is checked with the exchange first, and a key that can withdraw is refused (Gate.io doesn't report this, so check it yourself).
• Set an amount, press Start trading. The app runs each strategy on schedule and moves the account toward its target positions. Every order attempt is logged (state/audit.jsonl).
• Pause trading (keep positions) from the menu bar (system tray on Windows). After you quit and reopen the app, nothing trades until you press Start trading again.
• Paper trading needs no keys.

Backtests That Check for Overfitting and Use Real Fees

Overfitting: parameters that just happen to fit past data.

• MCPT p-value on every Type A backtest (lib/validation.py): could shuffled data have done as well?
• Parameter scan for a plateau, not the single best cell (lib/param_scan.py); walk-forward for out-of-sample results (lib/walk_forward.py).
• Real fees: a fee of 0 gets a warning (lib/quality_check.py).
• One idea, one backtest: a poor result is reported as it is, not quietly re-tuned (Iteration Brakes in AGENTS.md).

No Ideas? It Searches the Web for You

Press Search the Web for Ideas and the agent reads a dozen-odd sites, then brings back three backtestable ideas, each with entry and exit rules and its source URL. Pick one and it builds and backtests it. The pages it reads open in the app's built-in browser, on your screen; exchange account pages and private-network addresses are blocked.

Quick Start

Download the app for macOS or Windows (macOS 13+, or Windows 10/11 x64) and open it.

On first launch you choose what powers the agent:

• Your own Claude Code or Codex. No Blave account needed; Blave charges nothing for the AI.
• Your own DeepSeek key. DeepSeek bills you directly. The key stays in this computer's keychain and never reaches the agent.
• Blave AI. Sign in with a Blave account; billed by usage.

Then describe an idea:

• "Backtest BTCUSDT on the 4h chart: long when the 20-period SMA crosses above the 60-period SMA, flat when it crosses back below. Use a 0.05% fee per side."
• "Scan both SMA lengths on that strategy and show me where the plateau is."

The agent sorts every idea into one of three types before writing code:

• The packaged macOS app is a universal build (Apple Silicon and Intel). Windows: the versions Electron 44 supports; ARM not tested. The Windows installer is not code-signed yet, so SmartScreen warns on first install: choose More info › Run anyway.
• Node.js version: shell/package.json › engines. The packaged app bundles its own Python 3.12; running from source uses your system Python (python3, or python on Windows) to create the venv.
• Codex comes inside the ChatGPT app — Microsoft Store “ChatGPT” on Windows (winget install --id 9PLM9XGG6VKS -s msstore), ChatGPT.app on Mac. On Windows, avoid the npm @openai/codex 0.161–0.162.1 builds for now (their sandbox is broken).
• With your own Claude Code or Codex, the app only launches the CLI; your credentials stay with it. A DeepSeek key is stored encrypted on Windows, and the app relays the agent's requests locally.
• npm.cmd runs even when PowerShell's execution policy blocks the npm script.
• The interface follows the system language (English or Traditional Chinese). To override: BLAVE_LANG=en npm start (PowerShell: $env:BLAVE_LANG="en"; npm.cmd start).

From Source

You need macOS 13+ or Windows 10/11 (x64), Node.js 22.12+, Python 3 on your PATH, and one of: Claude Code or Codex signed in, a DeepSeek API key, or a Blave account.

git clone https://github.com/Blave-TW/blave-agent.git
cd blave-agent/shell
npm install
npm start

On Windows, run npm.cmd install and npm.cmd start in PowerShell.

News

What changed in each version: Releases.

Venues and Data

Venues with a tested order library (lib/account_*.py + lib/order_*.py, verified on real accounts):

• Binance, BingX, OKX, Gate.io, Bybit — futures and spot
• Capital Futures (群益期貨) — Taiwan index futures (TXF, MXF and TMF); Windows cloud machine only (its API is a Windows COM component, see references/capital-broker.md) — the desktop app cannot connect it on any OS, a Windows PC included. You upload your certificate in the app and the agent completes the setup on the cloud machine — no remote desktop needed.
• President Futures (統一期貨) — TXF, MXF and TMF; Windows only, because its certificate tool runs only on Windows 10 or later (see references/president-broker.md). On the Windows desktop app you upload the certificate and sign in inside the app. On a Windows cloud machine you apply for or export the certificate on your own Windows PC, upload it on the web workspace's Auto trading page and confirm the sign-in there — no remote desktop.

How a venue gets connected depends on where the agent runs:

• Desktop app: Binance, OKX, BingX, Gate.io and Bybit are connected in the app under Auto trading › Connect an exchange, which checks the key with the exchange first. A key pasted in chat is rejected — use Connect an exchange instead. Anything pasted stays in your chat history, so rotate a key you pasted by mistake. Type C strategies (one strategy holding several symbols by a weight vector — not the Portfolio page, which sets an amount for each of your strategies) can be auto-traded from the desktop app; if the workspace's lib is too old to trade them, they show as locked in Pick strategies until it is updated. A Type C strategy sized in contracts or shares places no orders, and Type C cannot be routed to President Futures or Capital Futures — saving an amount for it there is rejected.
• Cloud machine: bind a venue on the web workspace's Auto trading page, or paste a Binance, BingX, OKX, Gate.io or Bybit key in chat and the agent binds it with lib.venue.bind.

For any other exchange or broker with an API, the agent can write a helper from lib/account_TEMPLATE.py and lib/order_TEMPLATE.py. That code has not been tested by Blave.

Paper trading needs no keys. It ships as lib/account_paper.py + lib/order_paper.py and fills at the market's latest real price, never an adjusted one: crypto at Binance's last trade, TAIFEX futures at the latest minute, stocks at the unadjusted daily close (lib/paper_data.py).

Data.

• Desktop app, no account needed: crypto klines from Binance (USDT-M perpetuals, all intervals, back to listing) and BingX public endpoints; Taiwan stock daily bars straight from TWSE and TPEx with the exchanges' own ex-dividend adjustment (listed from 2010, OTC from the 1990s); Taiwan index futures daily bars from TAIFEX public data (since 1998); market-wide institutional net buying from TWSE (foreign investors since 2004); US stock and ETF daily bars (auto trading only through a single-symbol strategy on the stock's own perpetual, e.g. NVDA → NVDAUSDT); the Crypto Fear & Greed index (since 2018). Blave's indicators, Taiwan intraday and per-stock flow data, futures intraday bars and the rest of the futures data, and the macro calendar need a Blave account with data access.
• Cloud machine: market data comes from the Blave API through lib/data.py — crypto klines and indicators, Taiwan stocks, futures. US stock and ETF daily bars are fetched the same way as on the desktop app.

Safety and Limits

• Keys: give read and trade permission only. A key with withdrawal permission is refused whe