EthanAlgoX/AIStock

AI Stock – AIを活用した株式トレーダー向けリサーチワークスペース

概要

• 中国、香港、米国の株式について、個人トレーダーが自然言語で質問し、構造化されたリサーチレポートを得られるWebベースのプラットフォームです。中核となるエンジンはエージェントで、大規模言語モデル（LLM）による推論、決定的な金融ツール、およびトピックについて議論や投票ができるオプションの「エキスパート」エージェントを調整します。

仕組み

1. 会話ファースト – ユーザーはResearch assistantワークスペースでチャットを開始します。システムは市場データを取得したり、スクリーニングルールを実行したり、事前構築された金融「スキル」を呼び出したりできます。
2. 独立したエキスパートエージェント – 各エキスパートは、定義された役割（例：バリュエーション、マクロ、リスク）を持つ独自のLLM駆動エージェントとして実行されます。これらは3つのモードで連携できます：
   • パイプライン: タスクが分割され、順に渡されます。
   • ディベート: エージェントが議論し、モデレーターが要約します。
   • 投票: 各エージェントがレポートを提出し、レビューアーが投票し、モデレーターが結果を報告します。
3. レポートとラウンドテーブル – 最終出力は保存された読みやすいレポートです。ユーザーは各エキスパートの貢献を示す完全なラウンドテーブルのトランスクリプトも表示できます。
4. その他のワークスペース – マーケットレーダー、戦略スクリーニング、株式リサーチ実行、ペーパートレードシミュレーションがすべて統合され、同じタスク台帳と機能カタログを共有します。

主要コンポーネント

コンポーネント	役割
エージェント層	LLM呼び出し、ツール使用、エキスパート連携を調整
スキル	バージョン管理された金融手法（例：バリュエーションモデル、リスク指標）
組み込みツール	決定的なデータ取得と計算（価格履歴、ファンダメンタルズ、ニュース）
MCP（モデルコネクタプロキシ）	外部サービス（LLMプロバイダー、データAPI）のプラグインポイント
機能センター	スキル、ツール、データソース、エキスパートエージェントを有効/無効にするUI
ワークスペースUI	Reactベースのフロントエンド（React 19、Vite）で、各ワークフローに個別のルートを持つ
バックエンド	APIと静的Webビルドを提供するFastAPIサーバー

技術スタック

• Python 3.10+ – FastAPIバックエンド、エージェントオーケストレーション、データ処理。
• Node.js 20+ / npm 10+ – React 19フロントエンド（apps/dsa-web）。
• LLM統合 – 環境変数による設定可能なプロバイダー（例：DeepSeek）。ツール呼び出しモデルが必要です。
• Docker/仮想環境 – 必須ではありませんがサポートされています。CIはGitHub Actionsを使用します。

新規ユーザーの典型的なワークフロー

1. リポジトリをクローンし、Python仮想環境をセットアップします。
2. Python依存関係をインストールします（pip install -r requirements.txt）。
3. .env.exampleを.envにコピーし、LLM APIキー（例：DEEPSEEK_API_KEY）を追加します。
4. Reactアプリをビルドします（npm ci && npm run build）。
5. サーバーを実行します（python main.py --serve-only）。
6. http://127.0.0.1:8000を開き、Research assistantに移動し、「テンセントの成長見通しは？」のような質問をします。
7. 生成されたレポートを確認するか、Expert roundtableを開始して複数の視点を確認します。

安全性とガバナンス

• すべての機能（スキル、ツール、データソース、エキスパート）は、ワークスペースごとにホワイトリストで制御されます。
• エージェントは実際の注文を出すことはできません。ペーパートレードシミュレーションのみが許可されます。
• シークレットは環境に留まり、APIを通じて公開されることはありません。
• 実行ログは、タスクが完了したか、部分的に成功したか、ブロックされたかを記録します。

対象ユーザー

• 独自のパイプラインを構築せずにAI強化リサーチを求める個人株式トレーダーやアナリスト。
• LLM駆動の金融エージェントの構築に興味がある開発者。リポジトリは完全なエージェントスキルツールアーキテクチャを公開しています。

はじめに

# クローンと準備
git clone https://github.com/EthanAlgoX/InvestCrew.git AI-Stock
cd AI-Stock
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env   # 次にLLM APIキーを追加

# フロントエンドのビルド
cd apps/dsa-web
npm ci && npm run build
cd ../..

# サーバーの実行
python main.py --serve-only --host 127.0.0.1 --port 8000

UIにアクセスし、Settingsでモデルを設定して、探索を開始します。

ライセンス

• MITライセンス – 個人、研究、商用利用は無料ですが、生成された分析は投資アドバイスではないという通常の免責事項があります。

---

上記のすべての情報はリポジトリのREADMEから直接取得したものであり、追加の機能は推測されていません。