Skip to content

README_JA.md

Latest commit

 

History

History
263 lines (198 loc) · 14 KB

README_JA.md

File metadata and controls

263 lines (198 loc) · 14 KB
QuantDinger Logo

QuantDinger

プライベート AI クオンツ OS

チャート研究、AI 市場分析、Python インジケーター／ストラテジー、バックテスト、ライブ実行を、自前サーバーと自前 API キーでまとめて運用。

セルフホスト型クオンツ基盤：アイデアと AI 支援コーディングからペーパー系ワークフロー、取引所接続のライブまで。オプションでマルチユーザーと課金プリミティブ。

License Version Python Docker Stars

目次

クイックスタート · 関連リポジトリ · MCP / Agent · 概要 · 機能 · スクリーンショット · アーキテクチャ · インストール · ドキュメント · FAQ · ライセンス

QuantDinger は セルフホスト・ローカルファースト のクオンツ基盤です。AI 支援リサーチ、Python ネイティブ戦略、バックテスト、ライブ取引（暗号資産、IBKR 米株、MT5 FX）を 1 つの製品 にまとめます。

QuantDinger アーキテクチャ

データソースからインジケータ／シグナル／戦略／バックテスト／AI 分析へ、そして実行までのクローズドループ。

クイックスタート

前提: Docker + Compose、Git。Node.js は不要（frontend/dist にビルド済み UI 同梱）。

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

docker-compose が無い場合は docker compose を試してください。

Windows（PowerShell）

Docker Desktop を起動し、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 "Python 3 を 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）

Git for Windows の Bash なら、上記 macOS/Linux の 1 行コマンドが使えます。

ブラウザで http://localhost:8888 を開き、quantdinger / 123456 でログインし、直ちに管理者パスワードを変更してください。詳細は下記 インストールと初回起動 を参照。

関連リポジトリ

リポジトリ 内容
QuantDinger（本倉庫） バックエンド、Compose、ドキュメント、プリビルド Web
QuantDinger-Vue Web フロントソース（Vue）— npm run build で frontend/dist を差し替え
QuantDinger-Mobile モバイルクライアント（オープンソース）

MCP / Agent ゲートウェイ

Cursor / Claude Code / Codex など向けに Model Context Protocol（MCP） と Agent Gateway（/api/agent/v1）を提供。詳細は英語ドキュメントが一次情報です：

セキュリティ: 全 Agent 呼び出しは監査ログに記録。取引系（T）トークンはデフォルト ペーパーのみ；ライブにはサーバ側 AGENT_LIVE_TRADING_ENABLED=true とトークン paper_only=false の両方が必要です。

製品概要

セルフホスト可能な AI + Python 戦略 + バックテスト + ライブ の一体環境。認証情報は PostgreSQL と .env で管理。暗号取引所、IBKR、MT5、LLM は環境変数で接続。

ビジュアルツアー

デモ動画
▶ デモ動画を見る
IDE
インジケータ IDE・チャート・バックテスト		 AI
AI アセット分析
Bots
トレーディングボット		 Live
ライブ戦略・パフォーマンス

機能ハイライト

  • リサーチ & AI — マルチ LLM 分析、ウォッチリスト、履歴；NL→コード；Polymarket 研究フロー；Agent / MCP 連携。
  • 構築 — IndicatorStrategy と ScriptStrategy（on_bar）；プロ向け K 線 UI。
  • 検証 — サーバサイドバックテスト、エクイティカーブ。
  • 運用 — 暗号執行、クイックトレード、IBKR / MT5；Telegram、メール、Discord、Webhook 等。
  • プラットフォーム — Docker Compose、Postgres、Redis、OAuth、マルチユーザー、クレジット / メンバーシップ / USDT 課金スイッチ。

アーキテクチャ

flowchart LR
    U[トレーダー / 運用者]

    subgraph FE[フロント]
        WEB[Vue]
        NG[Nginx]
    end

    subgraph BE[バックエンド]
        API[Flask API]
        AI[AI サービス]
        STRAT[戦略・バックテスト]
        EXEC[執行]
    end

    subgraph DATA[データ]
        PG[(PostgreSQL)]
        REDIS[(Redis)]
    end

    subgraph EXT[外部]
        LLM[LLM]
        EXCH[取引所]
        BROKER[IBKR / MT5]
    end

    U --> WEB --> NG --> API
    API --> AI
    API --> STRAT
    API --> EXEC
    AI --> PG
    STRAT --> PG
    EXEC --> PG
    API --> REDIS
    AI --> LLM
    EXEC --> EXCH
    EXEC --> BROKER
Loading

インストールと初回起動

  1. リポジトリをクローンし、cp backend_api_python/env.example backend_api_python/.env
  2. SECRET_KEY を必ず設定（プレースホルダのままではバックエンドが起動しません）。Linux/macOS: ./scripts/generate-secret-key.sh
  3. docker-compose up -d --build
  4. Web: http://localhost:8888 · API ヘルス: http://localhost:5000/api/health
  5. 本番前にデフォルト管理者パスワードを変更。backend_api_python/.env の FRONTEND_URL を実際の URL に合わせる。

AI 機能には env.example の AI / LLM 節を .env に反映し、backend を再起動してください。詳細なチェックリストは 英語 README または 简体中文 を参照。

ドキュメント一覧

文書 内容
English README 完全版（英語）
简体中文 完全版（中国語簡体字）
CHANGELOG 変更履歴
Agent クイックスタート（英語） Agent Gateway / curl 例
戦略ガイド（英語） インジケーター／スクリプト戦略の開発

その他: multi-user-setup.md · IBKR · MT5 — 詳細は英語版が中心です。

よくある質問

本当にセルフホストできる？ はい。Docker Compose で自分のインフラ上に展開します。

暗号だけ？ いいえ。IBKR（米株）、MT5（FX）、Polymarket 研究にも対応。

Python で戦略を書ける？ はい。IndicatorStrategy と ScriptStrategy をサポート。

商用利用？ バックエンドは Apache 2.0。QuantDinger-Vue フロントは別のソース利用可能ライセンス—商用前に同梱条項を確認してください。モバイルは QuantDinger-Mobile のライセンスに従います。

モバイルは？ QuantDinger-Mobile を参照。

取引所紹介リンク（参考）

取引所 リンク
Binance 登録
OKX 登録
Bybit 登録

ライセンス

免責事項

QuantDinger は合法的な研究・教育・コンプライアントな取引向けです。投資助言ではありません。 利用は自己責任で。

コミュニティ

Star 履歴

Star History Chart

謝辞

Flask、Pandas、CCXT、Vue.js、KLineCharts、ECharts などオープンソースコミュニティに感謝します。

役に立ったら GitHub Star をお願いします。