by brokermr810
AI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
# Add to your Claude Code skills
git clone https://github.com/brokermr810/QuantDingerLast scanned: 5/16/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-16T06:21:10.865Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}Quick start · Repositories · AI agents & MCP · Overview · Features · Visual tour · Architecture · Install · Docs · FAQ · License
QuantDinger is a self-hosted, local-first quantitative platform: AI-assisted research, Python-native strategies, backtesting, and live trading (crypto, IBKR stocks, MT5 forex, Alpaca US stocks/ETFs/crypto) in one product—not a loose collection of scripts and SaaS tabs.
Three steps:
clone → set a secret key → docker compose up. On macOS/Linux it's one line. Most of this README is reference — new users don't need to read it to get started.
Prerequisites: Docker with Compose (Docker Desktop on Windows/macOS, or Docker Engine + Compose plugin on Linux), and Git. Node.js is not required (prebuilt UI is in frontend/dist).
git clone https://github.com/brokermr810/QuantDinger.git && cd QuantDinger && cp backend_api_python/env.example backend_api_python/.env && chmod +x scripts/generate-secret-key.sh && ./scripts/generate-secret-key.sh && docker-compose up -d --build
No comments yet. Be the first to share your thoughts!
If docker-compose is not found, try docker compose (Compose V2).
Use PowerShell (not CMD) in a folder where you want the project. Docker Desktop must be running (WSL2 backend recommended).
git clone https://github.com/brokermr810/QuantDinger.git
Set-Location QuantDinger
Copy-Item backend_api_python\env.example -Destination backend_api_python\.env
$key = & python -c "import secrets; print(secrets.token_hex(32))" 2>$null
if (-not $key) { $key = & py -c "import secrets; print(secrets.token_hex(32))" 2>$null }
if (-not $key) { $key = & python3 -c "import secrets; print(secrets.token_hex(32))" 2>$null }
if (-not $key) { Write-Error "Install Python 3 from python.org (tick 'Add to PATH') or use Git Bash with the macOS/Linux block above." }
(Get-Content backend_api_python\.env) -replace '^SECRET_KEY=.*$', "SECRET_KEY=$key" | Set-Content backend_api_python\.env -Encoding utf8
docker-compose up -d --build
If docker-compose is not recognized, use docker compose (space, no hyphen). If Git is missing, install Git for Windows.
Easier alternative: if you installed Git for Windows, open Git Bash and just run the macOS/Linux one-liner above.
Then open http://localhost:8888, sign in with quantdinger / 123456, and change the default admin password before any real use. That's it — go play.
For deeper configuration, first-run checks, and troubleshooting, see Installation & first-time setup further down (everyone else can skip it).
This monorepo ships the backend, Docker Compose stack, documentation, and a prebuilt web UI under frontend/dist. Use the sibling repos when you need source-level UI changes or the mobile app:
| Repository | What it is |
|------------|------------|
| QuantDinger (this repo) | Backend (Flask/Python), deployment, docs, bundled web assets |
| QuantDinger-Vue | Web frontend source (Vue)—themes, forks, npm run build → replace frontend/dist |
| QuantDinger-Mobile | Open-source mobile client—pairs with your self-hosted or SaaS backend |
Note: Node.js is only required if you build the web UI from QuantDinger-Vue; the default Docker quick start does not need it.
QuantDinger ships an Agent Gateway at /api/agent/v1 plus a small MCP server (quantdinger-mcp on PyPI) that wraps it as Model Context Protocol tools. Issue a token once and your AI client can read markets, manage strategies, run backtests, and (paper-only by default) place trades — without ever seeing your exchange keys or your admin JWT.
Every agent call is audit-logged, and trading-c