OpenByteInc/QuantDinger

QuantDinger – オープンソースAI駆動型取引オペレーティングシステム

何であるか – QuantDingerは自己ホスティング型のプラットフォームで、取引アイデアをフルスタックのワークフローに変換できます：Pythonで戦略を記述し、バックテストを行い、紙取引のシミュレーションを実行し、（オプションで）暗号資産取引所や伝統的なブローカーでリアルな注文を実行できます。このスタックはAI支援型の市場調査を基盤としており、LLMプロバイダー（OpenAI互換、Google、DeepSeekなど）を接続してシグナルを生成したりデータを拡張できますが、実際の戦略コード、リスクパラメータ、資格情報はすべてあなたの管理下にあります。

---

コアコンポーネント

コンポーネント	役割
API (Flask + Gunicorn)	HTTPエントリーポイント、認証、検証、永続的なコマンド送信。
トレーディングワーカー	長期間実行される戦略ランタイムをホストし、ブローカー接続を維持し、注文を照合し、PostgreSQLにリース/ハートビートを書き込みます。
スケジューラワーカー	ポートフォリオレベルのスケジュール、支払い、シグナルタイミングを制御します。
Celeryワーカー + beat	AI駆動の調査、バックテスト、実験レポート、メンテナンスタスクなど、有限で再試行可能なジョブを実行します。
PostgreSQL	永続的な状態：ユーザーアカウント、戦略定義、監査ログ、注文履歴。
Redis（キャッシュ＆ジョブ）	マーケットデータの高速キャッシュと、Celeryジョブキュー用の別々のRedisインスタンス。
観測スタック（オプション）	Prometheusがメトリクスを収集し、Grafanaが可視化し、Alertmanagerがアラートを処理します。
エージェントゲートウェイ / MCP	外部AIエージェント（例：Claude、Cursor）が承認された取引ツールを呼び出すための軽量API（/api/agent/v1）で、資格情報が漏洩することなく利用可能です。

---

アーキテクチャの概要

システムは、単一のイメージを使用するが異なるコマンドで起動するDockerコンテナのセットとして動作します（バックエンド、トレーディングワーカー、スケジューラワーカー、Celeryワーカーなど）。実行時の境界は明確です：

• HTTP APIは長期間のループを実行しない。それらは専用ワーカーにあります。
• Celeryは短期間で再試行可能なタスクを処理し、トレーディングワーカーは永続的な戦略ランタイムを所有します。
• 別々のRedisインスタンスにより、キャッシュとジョブキューの異なる削除ポリシーが強制されます。
• プロダクションオーバーレイでは、非rootユーザーとしてコンテナを実行し、読み取り専用のルートファイルシステムと制限されたLinux能力を使用します。

簡略化されたフロー：

1. 戦略作成者 は Strategy API V2（シグナル、サイズ、リスク）を実装するPythonモジュールを記述します。コードはデータベースに保存されます。
2. AIプロバイダー（OpenRouter、OpenAIなど）は、戦略内または別々の「研究」Celeryジョブから呼び出され、感情分析、ニュース、アイデア生成を取得できます。
3. バックテスト ジョブはCeleryで実行され、データソースアダプターから歴史的マーケットデータを取得し、結果を保存します。
4. 紙取引／リアル実行 はトレーディングワーカーによって行われ、取引所アダプター（Binance、OKX、Bybit、Gate、HTX）またはブローカーAPI（IBKR、Alpaca）と通信します。
5. モニタリング – メトリクスはPrometheusに流れ込み、Grafanaのダッシュボードで注文フロー、レイテンシ、健全性を表示します。

---

クイックスタート

オプションA – 事前ビルドされたDockerイメージ（推奨）

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/OpenByteInc/QuantDinger/main/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/OpenByteInc/QuantDinger/main/install.ps1 | iex

インストーラーは管理者ユーザー名/パスワードをプロンプトし、シークレットを生成し、GHCR Composeスタックを取得して起動します。その後、以下のアドレスを開くことができます：

• Web UI – http://127.0.0.1:8888
• モバイルH5 UI – http://127.0.0.1:8889
• APIヘルス – http://127.0.0.1:5000/api/health

オプションB – ソースからビルド

git clone https://github.com/OpenByteInc/QuantDinger.git
cd QuantDinger
cp backend_api_python/env.example backend_api_python/.env
cp .env.example .env
# .envファイルを編集 – SECRET_KEY、CREDENTIAL_ENCRYPTION_KEY、ADMIN_*、POSTGRES_PASSWORD、REDIS_PASSWORDなどを設定
python -c "import secrets, sys; print(secrets.token_hex(32))"  # ランダムなシークレットを生成
docker compose up -d --build   # コアサービスを起動（観測スタックは含まない）

フルプロダクションハードニングセットアップには docker-compose.production.yml を追加し、必要に応じて docker-compose.observability.yml を追加します。

---

セキュリティとコンプライアンスのハイライト

• 資格情報の暗号化 – ブローカーAPIキーとMFAシークレットは、ユーザーが提供する CREDENTIAL_ENCRYPTION_KEY で永続的に暗号化されます。
• エージェントトークン – ハッシュ化、スコープ制限、レート制限、監査ログ付き。リアル取引はエージェント経由で行うには明示的なトークン、paper_only=false、およびサーバーフラグ AGENT_LIVE_TRADING_ENABLED=true が必要です。
• コンテナのハードニング – 非root UID（10001）、能力のドロップ、読み取り専用ルートFS、プロダクションオーバーレイでのリソース制限。
• ネットワークポジション – すべてのポートはデフォルトで 127.0.0.1 にバインドされます。パブリック公開はTLS終端リバースプロキシ経由で行うべきです。
• 脆弱性報告 – SECURITY.md を参照して、プライベートな開示プロセスを確認してください。

---

どのような用途に適しているか？

用途	QuantDingerが提供するもの
独立系量化トレーダー	研究 → バックテスト → 紙取引 → リアルのエンドツーエンドパイプラインで、コードの完全な所有権を保証。
AI強化戦略開発者	LLMを呼び出すための組み込みフックで、感情分析、ニュース要約、アイデア生成が可能。
小さなフィンテックチーム	コンテナ化された自己ホスティングスタックで、単一のVMで実行可能またはKubernetesでスケーリング可能。
エージェントの研究プロトタイピング	エージェントゲートウェイ/MCPにより、外部LLMにツール呼び出しAPIを公開可能で、資格情報が漏洩しない。
教育者／趣味の開発者	1コマンドインストーラーと豊富なドキュメント（インジケータガイド、戦略ガイド、拡張ガイド）により、実験が容易。

---

ライセンスとコミュニティ

• ライセンス：Apache 2.0 – 拡張性があり、商業利用に適しています。
• 支援：Atlas Cloud（AI推論）とAmazon Web Services（クラウドインフラ）。
• コミュニティチャンネル：Telegram、Discord、YouTube、X（Twitter） – READMEにリンクあり。
• ドキュメント：英語および中国語ドキュメント、APIリファレンス、アーキテクチャ図、ステップバイステップのデプロイガイド。

---

まとめ

QuantDingerは、伝統的なアルゴリズム取引インフラとAI駆動の研究、エージェント統合を組み合わせた本格的でプロダクショングレードのオープンソースプロジェクトです。単なるデモではなく、完全なバックエンド、ワーカープロセス、CIパイプライン、セキュリティハードニング、オプションの観測スタックを含んでいます。自己ホスティング可能で拡張性のあるプラットフォームで、AI強化取引戦略を開発・テスト・実行したい場合、QuantDingerは非常に良い出発点です。