README_VI.md

May 26, 2026 · View on GitHub

QuantDinger

Hệ điều hành giao dịch định lượng AI riêng tư của bạn

Một stack Docker cho biểu đồ, nghiên cứu đa LLM, chiến lược Python, backtest cấp tổ chức và live đa venue—tự host hoàn toàn, khóa của bạn, dữ liệu của bạn.

quant OS mã nguồn mở: AI hỗ trợ code → backtest → paper → live (crypto/IBKR/MT5/Alpaca), tích hợp Agent Gateway & MCP.

English · 简体中文 · 日本語 · 한국어 · ไทย · Tiếng Việt · العربية

SaaS · Video demo · Trang web · AWS Marketplace

Version

Mục lục

Bắt đầu nhanh · Điểm nổi bật kỹ thuật · Kho liên quan · MCP / Agent · Tổng quan · Tính năng · Ảnh màn hình · Kiến trúc · Cài đặt · Tài liệu · FAQ · Giấy phép

QuantDinger là quant OS tự lưu trữ, ưu tiên cục bộ — không phải chatbot có nút mua. Gom nghiên cứu đa LLM, chiến lược Python gốc, backtest phía server và live đa broker (10+ crypto venue, IBKR, MT5, Alpaca) trong một stack production bạn kiểm soát hoàn toàn.

_{Từ zero đến chạy được—biểu đồ, AI nghiên cứu và workflow chiến lược trong vài phút.}

_{Vòng lặp 5 tầng: Ý tưởng → Chỉ báo → Chiến lược → Backtest → Tối ưu → Thực thi → Giám sát}

Điểm nổi bật kỹ thuật

	Điểm khác biệt của QuantDinger
quant OS full-stack	Biểu đồ, IDE, AI, backtest, bot live, quick trade, quản lý broker—một sản phẩm
Agent-native	Agent Gateway + PyPI `quantdinger-mcp` — Cursor / Claude Code / Codex, audit log
Hai runtime chiến lược	`IndicatorStrategy` (tín hiệu vector) và `ScriptStrategy` (`on_bar`)
Đa venue	CCXT crypto, IBKR, MT5, Alpaca — trang tài khoản broker thống nhất
Hạ tầng production	PostgreSQL 16 + Redis 7, Worker, ảnh GHCR multi-arch
Bảo mật	Từ chối `SECRET_KEY` mặc định, token hash, mặc định chỉ paper

Bắt đầu nhanh

Yêu cầu: Docker + Compose v2. Không cần Node.js (kéo frontend từ GHCR).

Cài đặt một dòng (Linux / macOS)

curl -fsSL https://raw.githubusercontent.com/brokermr810/QuantDinger/main/install.sh | bash

Mặc định ~/quantdinger. Chạy lại để pull ảnh mới. → http://localhost:8888 (quantdinger / 123456, đổi mật khẩu ngay).

Chuẩn: clone kho (macOS / Linux)

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

Nếu không có docker-compose, dùng docker compose.

Windows (PowerShell)

Bật Docker Desktop, rồi trong PowerShell:

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) { Write-Error "Thêm Python 3 vào PATH." }
(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

Windows (Git Bash)

Trong Bash của Git for Windows có thể dùng lệnh một dòng như trên macOS/Linux.

Mở http://localhost:8888, đăng nhập quantdinger / 123456, rồi đổi mật khẩu quản trị ngay. Chi tiết xem Cài đặt và chạy lần đầu.

Kho liên quan

Kho	Nội dung
QuantDinger (kho này)	Backend, Compose, tài liệu, web đã build
QuantDinger-Vue	Mã nguồn web (Vue) — tag `v*` tự động phát hành `ghcr.io/brokermr810/quantdinger-frontend`
QuantDinger-Mobile	Ứng dụng di động (mã nguồn mở)

MCP / Agent Gateway

Dành cho Cursor / Claude Code / Codex: Model Context Protocol (MCP) và Agent Gateway (/api/agent/v1). Tài liệu chi tiết bằng tiếng Anh là nguồn chính:

Hướng dẫn kết nối: MCP_SETUP.md — Hosted / tự host, stdio cục bộ, HTTP từ xa, Claude Code CLI gộp trong một trang.
AGENT_QUICKSTART.md · AI_INTEGRATION_DESIGN.md · agent-openapi.json
Máy chủ MCP: ../mcp_server/README.md · PyPI quantdinger-mcp

Bảo mật: Mọi lệnh gọi Agent được ghi vào nhật ký kiểm toán. Token giao dịch (T) mặc định chỉ giấy; giao dịch thực cần cả AGENT_LIVE_TRADING_ENABLED=true trên máy chủ và paper_only=false trên token.

Tổng quan sản phẩm

Môi trường AI + chiến lược Python + backtest + live tự host. Thay bộ TradingView + Notebook + chat AI + bot sàn bằng một stack Docker có thể kiểm toán. Thông tin xác thực trong PostgreSQL và .env.

Điểm nổi bật

Nghiên cứu & AI — Đa LLM, NL→code, Agent / MCP (scoped token, SSE).
Xây dựng — IndicatorStrategy / ScriptStrategy, UI K-line chuyên nghiệp.
Xác minh — Backtest phía server (equity, drawdown, nhật ký lệnh).
Vận hành — 10+ crypto, IBKR / MT5 / Alpaca, trang broker thống nhất, Telegram / Discord / Webhook.
Nền tảng — Docker + GHCR, Postgres 16, Redis 7, OAuth, đa người dùng, billing, AWS Marketplace.

Kiến trúc

Nguyên tắc: Tách dữ liệu thị trường · chiến lược/backtest · thực thi. Nginx + Vue SPA, Flask + Gunicorn, PostgreSQL 16, Redis 7. Triển khai: install.sh một dòng, GHCR zero-repo, full repo Compose, AWS AMI, SaaS.

Tour hình ảnh

_{▶ Xem video demo}
_{IDE chỉ báo, biểu đồ, kiểm thử lùi}	_{Phân tích tài sản bằng AI}
_{Bot giao dịch}	_{Chiến lược thực & hiệu suất}

Cài đặt và chạy lần đầu

Clone rồi cp backend_api_python/env.example backend_api_python/.env
Phải đặt SECRET_KEY (giữ placeholder thì backend không khởi động). Linux/macOS: ./scripts/generate-secret-key.sh
docker-compose up -d --build
- Tùy chọn (không cần clone repo): kéo image backend + frontend đa kiến trúc (amd64/arm64) sẵn từ GHCR:
```
curl -O https://raw.githubusercontent.com/brokermr810/QuantDinger/main/docker-compose.ghcr.yml
curl -o backend.env https://raw.githubusercontent.com/brokermr810/QuantDinger/main/backend_api_python/env.example
docker compose -f docker-compose.ghcr.yml up -d
```
  Image mặc định: ghcr.io/brokermr810/quantdinger-{backend,frontend}:latest. Ghim đồng thời cả hai bằng IMAGE_TAG=v3.0.9 trong .env cục bộ, hoặc ghim từng bên với BACKEND_TAG / FRONTEND_TAG.
- Phát triển frontend cục bộ: clone QuantDinger-Vue vào ./QuantDinger-Vue/ (đã gitignore) rồi chạy docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build. Chi tiết xem README tiếng Anh.
Web: http://localhost:8888 · Sức khỏe API: http://localhost:5000/api/health
Đổi mật khẩu quản trị mặc định trước production. Đặt FRONTEND_URL trong backend_api_python/.env đúng URL thực tế.

Tính năng AI: sao chép mục AI / LLM từ env.example sang .env, rồi khởi động lại backend. Danh sách đầy đủ xem README tiếng Anh hoặc 简体中文.

Danh sách tài liệu

Tài liệu	Mô tả
English README	Bản đầy đủ (Anh)
简体中文	Bản đầy đủ (Tiếng Trung giản thể)
CHANGELOG	Lịch sử phiên bản
Agent nhanh (Anh)	Agent Gateway / ví dụ curl
Hướng dẫn chiến lược (Anh)	Phát triển chiến lược chỉ báo·script

Khác: multi-user-setup.md · IBKR · MT5 — chi tiết chủ yếu bằng tiếng Anh.

Câu hỏi thường gặp

Có thật sự tự host được không? Có, triển khai bằng Docker Compose trên hạ tầng của bạn.

Chỉ tiền mã hóa? Không. Hỗ trợ IBKR / Alpaca (cổ Mỹ · ETF · tiền mã hóa) và MT5 (FX).

Viết chiến lược bằng Python được không? Có, hỗ trợ IndicatorStrategy và ScriptStrategy.

Thương mại? Backend Apache 2.0. Frontend QuantDinger-Vue có giấy phép riêng—đọc kỹ trước khi dùng thương mại. Di động theo QuantDinger-Mobile.

Có ứng dụng di động không? Xem QuantDinger-Mobile.

Liên kết giới thiệu sàn (tham khảo)

Sàn	Liên kết
Binance	Đăng ký
OKX	Đăng ký
Bybit	Đăng ký

Giấy phép

Backend: Apache License 2.0 (../LICENSE)
Web UI đi kèm: phân phối dựng sẵn. Mã nguồn tại QuantDinger-Vue (giấy phép riêng)
Thương hiệu: ../TRADEMARKS.md

Tuyên bố miễn trừ

QuantDinger dành cho nghiên cứu, giáo dục và giao dịch tuân thủ hợp pháp. Không phải tư vấn đầu tư. Bạn tự chịu trách nhiệm khi sử dụng.

Cộng đồng

Telegram · Discord · Issues
Email: support@quantdinger.com

Xu hướng Star

Lời cảm ơn

Cảm ơn cộng đồng mã nguồn mở: Flask, Pandas, CCXT, Vue.js, KLineCharts, ECharts và nhiều dự án khác.

_{Nếu hữu ích, hãy cho một ngôi sao trên GitHub.}