lc2panda/alphastream

alphastream 是一个由 AI 驱动的投资决策平台，通过多 Agent 协同编排系统，实时流式输出覆盖全球金融市场的深度洞察。基于 LangGraph 和 Python 构建，它无缝整合技术指标、基本面数据、资金流向分析和情绪智能，形成动态自适应的工作流。不同于传统的回测工具，alphastream 通过 SSE 将完整的决策过程——从数据获取、工具调用到最终推理——全程可视化，为投资者提供透明的可执行智能。

📊 Alphastream – AIネイティブ金融分析プラットフォーム

何であるか – ユーザーがLLM駆動のマルチエージェントシステムとチャットすることで、株式、ETF、インデックス、マクロデータを分析できるフルスタックWebアプリケーション。リアルタイム市場データ、テクニカル分析チャート、ファンダメンタルデータ、ニュースセンチメント抽出、および14の専門エージェント（さらに4つの「投資ガルド」人格）をLangGraphでオーケストレーションした統合プラットフォーム。バックエンドはFlask + Pythonサービス、フロントエンドはTailwind、shadcn/ui、TradingViewの軽量チャートを用いたNext.js 16 + React 19 UIで構築。すべてのコンポーネントは1つのDocker-Composeコマンドで起動可能。

コア機能

機能	動作方法（READMEに記載）
AIチャットとマルチエージェントオーケストレーション	OpenAI SDKを介してDeepSeek V4（または任意のOpenAI互換モデル）を使用。LangGraphが14のエージェント（テクニカル、ファンダメンタル、キャピタルフロー、センチメント、バブル/ベア議論、リスク、意思決定、リフレクション、戦略進化、さらに4つの投資家ペルソナエージェント）を動的にルーティング。エージェントは関数コールでツールを呼び出し、全プロセスはServer-Sent Events（SSE）でUIにストリーミングされる。
リアルタイム市場データ	中国A株、米国株（SEC EDGAR）、香港、ETF、インデックス、マクロシリーズ（FRED/NBS）および暗号資産（ccxt/CoinGecko）の冗長性を提供する2つのソースアダプタ（AKShare + BaoStock）。テクニカルインジケータ（K線、MA/EMA、MACD、RSI、ボリンジャーバンド、出来高）およびファンダメンタル指標（PER、PBR、ROE、財務諸表）はRESTエンドポイントで公開。
スマートニュース＆センチメント	6つのソースからのRSSを集約し、OpenCLIクローラーでSnowball、東方財経フォーラム、財新をクロール。LLMがセンチメントとホットトピックタグを抽出。
統合検索	17の検索エンジン（中国8、グローバル9、知識グラフ2）を並列でクエリし、重複除去後にエージェントまたはUIに返却。
UI/UX	ダークグラスモルフィズムデザイン、レスポンシブな3カラムレイアウト、10の「アーティファクトカード」（チャート、リスクレーダー、意思決定カードなど）、Zustand（ローカルストレージ）による永続状態保存。
ストリーミング＆観測性	バックエンドはSSEイベント（`agent.started`、`agent.progress`、`agent.tool_call`、`agent.completed`、`agent.error`）を発行。ヘルス、メトリクス、アダプタステータスエンドポイントを提供。
デプロイ	Docker Compose（単一コマンド開発用）、別々のフロントエンド/バックエンドComposeファイル、Nginx TLS終端付きのプロダクションCompose。オプションでRedisキャッシュとSQLite DB。

技術スタック（リスト通り）

フロントエンド: Next.js 16.2.9, React 19, Tailwind 4, shadcn/ui, Zustand, Jotai, TradingView Lightweight Charts, Recharts。
バックエンド: Flask 3.1 + Gunicorn + Gevent, Python 3.11+, LangGraph（LangChain）、OpenAI互換SDK。
データアダプタ: A株、米国SEC、香港、マクロ（FRED/NBS/世界銀行/IMF）、暗号資産、代替データ（船舶、衛星、企業登記、雇用、ESG）をカバーする21のアダプタ。
検索: Baidu、Google、Bing、知乎、微博など17のエンジンに加え、WolframAlpha/Wikipedia。
キャッシュ: Redis 7（オプション）+ インメモリフォールバック。
コンテナ化: Docker、Docker-Compose、Nginx 1.25+。

クイックスタート

クローンと設定

git clone https://github.com/lc2panda/alphastream.git
cd alphastream
cp .env-example .env   # OPENAI_API_KEY & URL は最低限記入

すべて起動

docker compose up -d   # redis、バックエンド、フロントエンド、Nginxを起動

ブラウザで http://localhost:3000 を開く。
- フロントエンドはポート3000で、バックエンドAPIは8888で動作。Nginxがポート80で両方をプロキシ。
- エージェントが思考・ツール呼び出し・最終分析をストリーミングする際、チャットパネルにSSEストリームが表示される。

代替案 – 開発用にバックエンド（python3 run.py）とフロントエンド（npm run dev）を個別に起動、またはより細かい設定用に提供された docker-compose.frontend.yml / docker-compose.prod.yml を使用。

一般的な利用例

インタラクティブな株式リサーチ – 「TSLAの次四半期の見通しは？」とAIに尋ね、テクニカル、ファンダメンタル、センチメントエージェントがデータを取得し、計算を実行、構造化された回答をストリーミング。
ポートフォリオ監視 – ダッシュボードはリアルタイムインデックス、個人ウォッチリスト価格、リスクレーダーカードを表示。
戦略バックテスト支援 – 「戦略進化者」エージェントを使ってトレードアイデアを反復改善。システムが自動的に関連データを取得し、アプローチをスコアリング。
ニュース駆動のアラート – ニュースアグリゲーターとセンチメントエージェントに最新の市場動向を引き出すことで、重要なヘッドラインを検出。

ライセンスと貢献

リポジトリには完全な貢献ガイド、CIパイプライン（Lint、ユニット、統合、アダプタ健全性チェック）およびテストスイート（バックエンド約800テスト、フロントエンド40+テスト）が含まれます。フォーク＆プルリクエストワークフローで貢献を歓迎します。

免責事項 – このプラットフォームは探索用にのみ提供されています。出力は投資アドバイスではなく、誤りを含む可能性があります。