Auto-Trader/README_ja.md

English | 中文 | 日本語 | 한국어 | العربية

Vibe-Trading: あなた専用のトレーディングエージェント

1つのコマンドで、包括的なトレーディング能力をエージェントに付与

公式サイト  ·  ドキュメント  ·  ニュース  ·  機能  ·  Shadow Account  ·  デモ  ·  クイックスタート  ·  例  ·  API / MCP  ·  ロードマップ  ·  Contributing

---

📰 ニュース

• 2026-07-01 🧹 Security polish + tracker cleanup：API/Docker/frontend dev defaults を締め、Settings channel と zh-CN edges を安定化し、frontend dependency/CSP alerts を解消、古い WhatsApp + paper-trading tracker items も整理しました（#338、#351、#349、#365、#367、#350、#335、#283）。

• 2026-06-30 💬 研究配信用の IM チャンネルランタイム：Vibe-Trading は同じ agent session runtime を 16 の組み込み message adapter に接続できるようになりました——WebSocket、Telegram、Slack、Discord、Matrix、WhatsApp、Signal、QQ/NapCat、WeChat/WeCom、Feishu/Lark、DingTalk、Teams、email、Mochat。CLI（vibe-trading channels status/start/stop/login/pairing）、REST（/channels/status、/channels/start、/channels/stop、/channels/pairing/command）、Web UI Settings panel が status、recovery hints、start/stop、sender pairing を扱い、SDK-backed adapters は vibe-trading-ai[telegram] や vibe-trading-ai[channels] などの extras の背後に残ります（#341）。

• 2026-06-29 🛡️ Live advisory safety + Trading 212 read-only connector + Windows/Gemini fixes: live order guards now have an opt-in, broker-agnostic PreTradeAdvisoryInterface that records advisory reviews without bypassing the mandate gate, kill switch, or audit trail (#328, closes #317, thanks @shadowinlife). Trading 212 joins the connector layer with read-only account, positions, orders, history, and instrument-metadata support; place_order / cancel_order still hard-refuse until a structural paper/live boundary exists (#321, closes #309, thanks @mvanhorn). Windows startup avoids the pandas 3.0 Timestamp crash via the <3.0.0 constraint (#329, closes #324, thanks @hannibal-lee); Gemini thought_signature dict-history replay was verified/fixed on main (#318); .US financial statements now route to SEC EDGAR instead of Eastmoney (#325); and the Alpha Library landing page got cache/date/selector/noscript/DNS-prefetch hardening while heavier CSP and social-card follow-ups stay tracked (#323).

過去のニュース

• 2026-06-28 🧰 クロスプラットフォーム setup/dev + runtime と file tool の強化：vibe-trading setup と vibe-trading dev は、Windows の TypeScript build、正しい cwd からの backend 起動、Vite の 5899 port、終了時の子プロセス cleanup を正しく扱うようになりました（#292、@digger-yu さんに感謝）。Runtime status polling はクラッシュせず graceful に degrade し（#322）、MCP OAuth cache key は sanitize され（#313）、OpenAI default と Robinhood agent.json validation も強化されました（#319、#320、@mvanhorn さんに感謝）。File tools には独立した read/write roots と sandbox tests の拡充も入りました（#299、@skloxo さんに感謝）。

• 2026-06-27 🧯 Content-filter resilience + Shadow Account feature contract cleanup：event-driven / swarm run は、個別の LLM content-moderation hit をスキップし、filter rate が高い場合は run card で警告し、Gemini safety finish reason を認識して analysis 全体を abort しないようになりました（#308、#307 をクローズ、@shadowinlife さんに感謝）。Shadow Account の extraction/codegen は同じ PRICE_FEATURES contract を共有し、4 桁小数の return bounds を保つことで、rule/codegen drift と prior_5d_return の精度落ちを防ぎます（#316、@Robin1987China さんに感謝）。

• 2026-06-26 🎯 Shadow Account の条件付きエントリー + tushare ETF/指数/HK ルーティング：抽出された Shadow Account ルールが RSI / prior-return のレンジを持つようになり、生成される SignalEngine は保有サイクルを盲目的に再生せず、実際の条件（RSI がレンジ内、prior-return がレンジ内）でエントリーします（#314、#302 の follow-up、@Robin1987China さんに感謝）。tushare loader も ETF/LOF を fund_daily()、指数を index_daily()、香港株を hk_daily() にルーティングし、非株式に対して静かに空を返す daily() を常に呼ぶのをやめ、銘柄ごとの空結果 + 部分取得の警告を追加しました（#315、#310 をクローズ、@shadowinlife さんに感謝）。

• 2026-06-25 🧪 strict validation JSON + 落ち着いた agent context：単独のバックテスト validation は、artifacts/validation.json や CLI stdout に書き出す前に入れ子の NaN / Infinity を正規化するようになり、strict JSON parser が validation payload で詰まらなくなりました（#306、@gyx09212214-prog さんに感謝）。Agent prompt も loader registry から現在の data-source 数を動的に導出し、_microcompact() は本当に token pressure がある時だけ動くため、短い実行で古い tool result が早すぎるタイミングで消されません（#296、#282 をクローズ、@MarkfuGod さんに感謝）。

• 2026-06-24 🎯 Shadow Account の価格コンテキスト + reactive Chinese UI + LAN auth 修正：Shadow Account のルール抽出は、buy_dt 時点の point-in-time-safe な entry context（entry_rsi14 と prior_5d_return）を loader registry 経由で読めるようになり、offline / no-data では従来どおり graceful に落ちます（#302、#295 の follow-up、@Robin1987China さんに感謝）。Web UI の主要パネルは charts、chat、Alpha Library、Correlation、Run Detail まで reactive English / zh-CN translation に寄せました（#301、@skloxo さんに感謝）。CSRF hardening 後も、API_AUTH_KEY を設定した remote same-origin Web UI deployment は POST / upload が通る一方、mismatch した cross-site origin は引き続き拒否されます（#304、@Hinotoi-agent さんに感謝）。

• 2026-06-23 🛡️ ローカル API の CSRF 対策強化：悪意あるウェブページがループバック API に対して安全でないクロスサイトリクエスト（POST/PUT/DELETE）を発行できなくなりました——CORS はレスポンスの読み取りは防げても副作用は防げないため、ループバックの dev-mode 信頼を認める前に、安全でないメソッドへ既存のクロスサイトガードを適用します。安全なメソッドとローカル CLI / 非ブラウザのアップロードには影響しません（#293、@Hinotoi-agent さんに感謝）。

• 2026-06-22 🔧 ライブ認可の OAuth 修正 + Alpha Zoo 見出しの修正：connector authorize が数分かかるブローカーのサインインの間も OAuth ハンドシェイクを維持し（VIBE_LIVE_AUTHORIZE_TIMEOUT_SECONDS で調整可能）、リトライ時に競合するコールバックサーバーを起動しなくなったため、トークンが確実に保存されます（#281、#259 をクローズ、@Robin1987China さんに感謝）。Alpha Zoo ページが alpha 数を二重に表示しなくなりました（#287、#286 をクローズ、@digger-yu さんに感謝）。定期リサーチにも端から端までの使い方ドキュメントが追加されました（#288）。

• 2026-06-21 ⏰ 定期リサーチ実行エンジン + レポートライブラリ + バックテスト後アトリビューション：定期リサーチがエンドツーエンドで動作するようになりました——デフォルト無効のバックグラウンド実行エンジン（VIBE_TRADING_ENABLE_SCHEDULER）が interval/cron で期限到来ジョブをセッションランタイム経由で実行します（#278、@mvanhorn さんに感謝、#254 をクローズ）。新しい /reports 実行ライブラリページでは、レポートを生成した実行を一覧・検索・フィルタでき、Run Detail + Compare へのリンクも備えます（#224、@LemonCANDY42 さんに感謝）。さらにバックテストのたびにエージェントが階層型アトリビューション——取引レベルの勝ち/負けトップ、ベータ回帰、市場レジーム分析、モンテカルロ並べ替え検定——をデータの有無とルーティング条件に応じて自動実行します（#280、@shadowinlife さんに感謝）。

• 2026-06-20 🔬 Research Autopilot のループが完結（フェーズ3）+ ローダー OHLC 整合性ガード + 学術アルファ4本：Research Autopilot が 仮説 → シグナルエンジン → バックテスト をエンドツーエンドで実行します——scaffold_signal_engine が runner 契約に準拠したエンジンを生成し、link_autopilot_backtest がバックテスト指標を仮説へ自動で書き戻します（68 ツール）（#267）。構造的な OHLC 健全性チェックがローダー境界で不正な bar（high < low、非正の価格、high/low が open/close を包含しない）を一括除去し、すべてのデータソースを保護します（#274、@Shizoqua さんに感謝）。さらに academic アルファファミリーが 6 → 10 に拡大——Jegadeesh リバーサル、George-Hwang 52週高値、Amihud 非流動性、Harvey-Siddique 歪度（456 ファクター）（#277、@Robin1987China さんに感謝）。

• 2026-06-19 🚀 v0.1.10 — グローバルデータレイヤー：市場データソースが 10 → 18 に拡大（無料の Eastmoney / Sina / Stooq / Yahoo + キー必須の Finnhub / Alpha Vantage / Tiingo / FMP、IP-ban リスク順の fallback）。さらに 18 個の読み取り専用データツール（資金フロー、龍虎榜、北向き、信用取引、大口取引、SEC EDGAR + XBRL、財務、オプションチェーン、全市場スクリーニング…）を A 株 / 米国 / 香港にまたがり、すべて MCP 経由で公開。本リリースは 0.1.9 以降の全更新も同梱——10 のブローカーコネクタ、alpha compare、プロバイダ信頼性の大規模改修、任意のデータキャッシュ。pip install -U vibe-trading-ai

• 2026-06-18 🔬 Research Autopilot 第1フェーズ + ローカル Data Bridge ローダー、加えて Discord セキュリティ通知：新しい run_research_autopilot + generate_backtest_config が Hypothesis → Research Goal → backtest を端から端までつなぎ（現在 50 ツール）、新しい local ローダーは自分の CSV / Parquet / DuckDB ファイルから直接 OHLCV を読み込みます（#260、#252、@Robin1987China さんに感謝）。さらに DeepSeek DSML ツール呼び出しの解析と識別子封じ込め強化も入りました。⚠️ セキュリティ通知：以前のコミュニティ Discord 招待は、現在管理していないサーバー（偽の Collab.Land ウォレット「認証」フィッシング）に解決されます——すべて削除済みで、唯一の公式 Discord は HKUDS サーバー（discord.gg/6TdQnT5xcF）です。ウォレット接続を求めることは決してありません。

• 2026-06-17 🧩 インストール互換性 + Opus/Kimi プロバイダ修正：通常の pip install vibe-trading-ai では、任意機能の pyharmonics / ta 依存チェーンを引かなくなりました。harmonic detection は vibe-trading-ai[harmonic] extra の背後に移しつつ、同梱 fallback detector はそのまま使えます（#250、#249 をクローズ）。Agent loop は Opus 4.8+ が拒否する assistant-prefill handoff message を送らなくなり、Kimi/Moonshot は MOONSHOT_USER_AGENT で client User-Agent を上書きできます（#248、#246 と #204 をクローズ）。follow-up tests は background-result と auto-compact の handoff 経路を直接カバーします（#251）。

• 2026-06-16 🛡️ セキュリティ/API 強化 + GLM/Zhipu alias：Settings 書き込みは認証設定時に auth 必須になりました（#245）；API session の shell-capable tools は明示的な VIBE_TRADING_ENABLE_SHELL_TOOLS=1 opt-in が必要です（#243）；API key 設定時の local shutdown も auth 必須です（#241）；loopback に見えるが信頼できない Host は local 扱いせず拒否します（#242）。実行時の細部も改善: Web chat は完了済み attempts と同期し（#236）、run card は非有限メトリクスを strict JSON として出力（#238）、不正な RSSHUB_TIMEOUT_S / RSSHUB_FETCH_BUDGET_S は安全に fallback（#240）、ddgs retry fallback は regression coverage 付きです（#239）。GLM/Zhipu は first-class provider alias となり、model-name inference も追加されました（#247、#237 をクローズ）。

• 2026-06-15 🧭 Web 検索の堅牢化 + Web UI のラン継続性修正：web_search は単一エンジンがレート制限されても失敗しなくなりました——複数の無料・キー不要のエンジン（DuckDuckGo、Google、Bing、Brave、Mojeek、Yahoo）を順に照会し、リトライ/バックオフを行い、「結果なし」をエラーではなく空の回答として扱い、すべてのエンジンが制限された場合は素っ気ない ❌ ではなく実行可能なメッセージを返します（エンジン一覧は VIBE_TRADING_SEARCH_BACKENDS で上書き可能）（#232、#231 をクローズ、@Ethan-sun01 さんに感謝）。Web UI では、ラン中にページを切り替えても固まらなくなりました——チャットは戻った際にライブストリームへ再購読し、見逃した進捗を再生します（#234）——そして停止ボタンはイテレーション境界だけでなく、ストリーミング中やツール間でも有効になりました（#235）。これにより #229 の両方が解決します（@kalkinj さんに感謝）。baostock loader は tushare 形式の 601398.SH に加え、ネイティブの sh.601398 / sz.000001 コードも受け付けるようになりました（#230、@bhlt さんに感謝）。

• 2026-06-14 📊 ラン単位のトークン使用量 + Run Detail チャートの遅延読み込み: 各 agent ランは、プロバイダ報告のトークン使用量をラン単位の llm_usage.json として永続化するようになりました——プロバイダ/モデル、累計合計、イテレーションごとの件数——/runs/{id} に追加的に提供されるため、ランが終わってライブストリームが消えた後もトークンコストを監査できます（プロバイダ報告値のみ；prompt/内容のキャプチャや価格推定はなし）（#223、@LemonCANDY42 さんに感謝）。Run Detail ページは、もはや全シンボルのローソク足を最初に読み込みません: 既定の /runs/{id} レスポンスは変更なしのまま、UI はまずランのサマリーを描画し、オプトインの ?chart_payload=summary / ?chart_symbol= モードで各シンボルのチャートをオンデマンドに読み込みます。シンボルごとの読み込み状態と「全件読み込み + 進捗」コントロール付きです（#225、@LemonCANDY42 さんに感謝）。2 つの loader 修正で締めくくり: yfinance の排他的な end 境界が、要求範囲の最終取引日を取りこぼさなくなりました——ダウンロード呼び出しは end + 1 日 を渡し、キャッシュキーは元の範囲を保持します（#226、@gyx09212214-prog さんに感謝）——そして不正な CCXT_TIMEOUT_MS / OKX_TIMEOUT_S 値は、import 時に例外を投げて起動を妨げる代わりに、警告して既定値にフォールバックするようになりました（#227、@gyx09212214-prog さんに感謝）。

• 2026-06-13 ↩️ CLI からセッションを ID で再開: インタラクティブ CLI が終了時に session-id を表示し、コピペ可能な vibe-trading resume <session-id> のヒントも添えるようになりました——終了したランの trace を探すのに、agent/sessions/ 配下のどのフォルダがタイムスタンプ的に最新かを当てる必要はもうありません。新しい vibe-trading resume <session-id> サブコマンドはその正確なセッションを再び開き、直近のターンを loop に再生します；存在しない id は空のセッションを黙って始めるのではなく即座にエラーで終了します（#218、@zwrong さんに感謝）。

• 2026-06-12 🩺 プロバイダ信頼性の全面強化——DeepSeek ハング、Kimi 接続、ストリーミング死活：一連のプロバイダ報告——DeepSeek 実行が「Agent is working…」で停止（#208、@XYWOX さんに感謝）、reached max iterations がモデルの空応答を覆い隠す（#203、@mojianliang さんに感謝）、停止後に UI が復帰しない（#195、@mafia23 さんに感謝）、Kimi がクライアントを拒否（#204、@liao497 さんに感謝）——の根因は一つでした：すべての OpenAI 互換プロバイダが単一の shim を共有し、DeepSeek/Kimi/Gemini 固有の挙動をグローバルに適用し、ストリーム失敗を黙って握りつぶしていました。プロバイダ固有の挙動は明示的なケイパビリティ層に移行——reasoning の捕捉/再送、Gemini thought signature、Kimi の User-Agent、OpenRouter の reasoning body はそれぞれ自分のプロバイダにのみ適用され、相互汚染しません。reasoning のみのストリームはリアルタイムの**「Reasoning…」**インジケータを表示；ストリーム失敗は文脈付きの provider_stream_error を送出し、一時的な切断は 1 回だけ自動リトライ（決定的な 4xx は即時失敗）、遅い非ストリーミング呼び出しへの静かなフォールバックは廃止；モデルの空応答は empty_model_response として正しく診断；SSE ハートビートが再接続リプレイを壊さなくなり；スタックした読み取り専用ツールはタイムアウトします。新コマンド vibe-trading provider doctor は秘匿化済みの provider/モデル/パッケージ/プロキシのスナップショットを出力し、環境起因のハングをワンコマンドで切り分け。DeepSeek は pip install "vibe-trading-ai[deepseek]" で公式ネイティブアダプタを選択でき、kimi-k2.x の temperature=1 要件は自動適用——Kimi 経路は実 API でエンドツーエンド検証済みです（kimi-k2.6 のツール呼び出し + 厳格なマルチターン reasoning 再送）。

• 2026-06-11 🐝 swarm worker が loader 層経由で市場データを取得するように: NVDA の投資委員会ランで一連のギャップが露呈しました——worker が場当たり的な yfinance スクリプトを書き、欠損した最新バー（出来高はあるが OHLC が空）を信じ、NaN が非厳密 JSON に漏れ、コンテキストを失った継続プロンプトが誤った preset にルーティングされていました（#198、卓越した診断と 2 つの修正 PR を寄せてくれた @BillDin さんに感謝）。swarm worker は MCP と同じ正規化 loader レジストリに裏打ちされたローカル get_market_data ツールを獲得——厳密 JSON、非有限浮動小数は null として直列化——すべての市場データ系 preset（13 preset、21 worker）に配線され、プロンプトポリシーが OHLCV 作業をツール優先に誘導します（#199）。run_swarm は明示的な preset_name を受け取り、曖昧な継続フラグメントは equity_research_team へ静かにフォールバックせず拒否されます（#200）。グラウンディングも賢くなりました: swarm プロンプト内の裸の米国ティッカー（例 NVDA）は NVDA.US に昇格され（ストップワードでガード）、worker は最初から権威ある事前取得価格を手にします。このツールはメイン agent レジストリにも加わり——現在 48 ツールです。さらに: Docker のデータがアップデートを跨いで保持されるように——永続メモリ、セッション検索インデックス、ユーザー作成スキル、shadow account、broker 設定は名前付きボリュームに置かれ、docker compose up --build でも消えません（#197、@FlyerJ さんに感謝）。

• 2026-06-10 🐳 Docker からホスト側 Ollama に標準で到達可能に: コンテナ内の localhost はコンテナ自身を指すため、既定の OLLAMA_BASE_URL=http://localhost:11434 では Docker + Ollama 構成の LLM プリフライトが必ず失敗していました。docker-compose.yml は既定で http://host.docker.internal:11434 を指すようになり（OLLAMA_BASE_URL のエクスポートで上書き可）、host-gateway の extra_hosts マッピングも追加され、Docker Desktop だけでなく Linux でも同じファイルがそのまま動きます（#196、@ShahNewazKhan さんに感謝）。

• 2026-06-09 🔑 別マシンから Web UI を開いたときのエラーをより明確に: API_AUTH_KEY 未設定のまま非ループバッククライアント（別のマシン、VM ホスト、LAN 上のスマートフォン）からチャットにアクセスすると、メッセージ送信・セッション一覧・live ステータスなどすべての機微なエンドポイントが 403 を返していましたが、チャットには汎用的な「Failed to send message, please retry.」しか表示されませんでした。送信パスが本当の理由——「Remote API access requires an API key. Add it in Settings, or run the backend on localhost for local-only use.」——を表示するようになり、README の Web UI セットアップも localhost と LAN の違いと 3 つの対処法（同じマシンで localhost を使う／API_AUTH_KEY を設定して Settings に一度入力する／Docker Desktop のホストゲートウェイには VIBE_TRADING_TRUST_DOCKER_LOOPBACK=1）を明記しました（#191、@mafia23 さんに感謝）。

• 2026-06-08 🔧 Gemini 3.x マルチターンのツール呼び出し修正: Gemini 3.x の思考モデル修正が完成しました。6/05 のラウンドトリップ（#176）は in-memory 履歴のみを対象にしていましたが、実際の agent loop は履歴を OpenAI 形式の dict で再生し、LangChain がリクエスト構築前にツール呼び出しごとの thought_signature を捨てていたため、マルチターンのツール呼び出しが依然 missing thought_signature で 400 になっていました。これが invoke と stream が共有する唯一のチョークポイント _convert_input で再付与されるようになりました（並列呼び出し——N 個のうち最初の 1 つだけ署名される——も対象）（#184、@ngoanpv さんに感謝）。

• 2026-06-07 🐝 チャットのタイムラインにライブ swarm ステータス: agent がマルチエージェント swarm（投資委員会、クオンツデスク、リスク委員会……）を起動すると、チャットに各 worker の状態——待機 / 実行中 / 完了 / 失敗 / ブロック / リトライ——をリアルタイムにストリーミングするインラインステータスカードが表示されるようになりました。独立した swarm ダッシュボードと同じエージェント単位の可視性です。ランタイムイベントは既存の /swarm/runs API を変えずにセッション SSE ストリームへブリッジされ、再接続や履歴再生時には完了済みカードが最終的な run_swarm 結果から復元されます（#188、@BillDin さんに感謝）。preset ルーティングも精密に: 明示的に指定された preset（例 investment_committee、アンダースコアの有無を問わず）がキーワードスコアより優先され、裸の IV デリバティブキーワードが「given」のような普通の単語に誤マッチしなくなりました（#189、@BillDin さんに感謝）。

• 2026-06-06 ⚖️ Alpha 比較 —— CLI / Web UI / REST / agent の全面対応: 新しい alpha compare は、手で選んだ Alpha Zoo ファクターのショートリストを同じ universe・期間で総当たり比較し、IC 平均/標準偏差・IR・IC>0 比率・サンプル数で順位付けして、各ファクターのトップとの差を示します。zoo 全体の bench と違い、指定したファクターだけを評価します（新しい run_bench(only=…) のサブセットフィルタ）。3 つを比較しても zoo の 191 個すべてを走らせません。1 つの共有コアがすべての面を支えます: vibe-trading alpha compare <id1> <id2> … --sort ir（CLI）、Alpha Zoo Web UI の Compare ビュー（カタログでファクターをチェック → ワンクリック比較 + ストリーミング順位表）、POST /alpha/compare + SSE（REST）、読み取り専用の alpha_compare agent ツール（47 ツールに）。

• 2026-06-05 🇮🇳 Dhan + Shoonya connector（インド）——ブローカー計 10 社: connector-first の取引レイヤーにインド市場向けの Dhan と Shoonya（NSE/BSE 株式 + F&O）を追加し、ブローカーは計 10 社になりました。どちらもペーパー + 読み取り専用です——Longbridge と同様、API がランタイムのペーパー/live 判別子を公開しないため、place_order / cancel_order は最初の行で非ペーパー設定を硬く拒否します（ルール: ランタイムのペーパー/live ガードを持たないブローカーはペーパー + 読み取り専用に制限）（#181、#174 をクローズ）。今回は Gemini 2.5 / 3.x の思考モデルも修正: ツール呼び出しごとの thoughtSignature が OpenAI 互換パスを往復するようになり、マルチターンの function calling が INVALID_ARGUMENT で失敗しなくなりました（#176、#170 をクローズ、@mvanhorn さん & @jliu6789 さんに感謝）。452 個すべての Alpha Zoo ファクターに中国語 docstring（中文名称/说明/用途）が追加され（#180、@LeeCQiang さんに感謝）、**フロントエンドのテストスイート（vitest 197 件）**とバックエンドの認証 / パストラバーサル / CORS セキュリティテストが CI に加わりました（#175、@sambazhu さんに感謝）。

• 2026-06-04 🗃️ 全 7 データソース対応のオプトインローカルキャッシュ: 新しい VIBE_TRADING_DATA_CACHE スイッチにより、各バックテスト loader——tushare、okx、ccxt、akshare、mootdx、yfinance、futu——が確定済みの過去 bar を ~/.vibe-trading/cache（ユーザーホーム、リポジトリには決して書き込まない）にキャッシュし、繰り返しおよび長期 / クロスマーケットのバックテストがネットワークを省略してプロバイダーのレート制限を回避できます。デフォルトはオフ。バッチ / 接続型 loader（yfinance、futu）はキャッシュが全ヒットすると一括ダウンロード / FutuOpenD 接続を完全にスキップし、staleness ガードは当日で終わる範囲（最後の bar がまだ形成中）を決してキャッシュせず、キャッシュされたフレームは新規取得とバイト単位で一致します（#177、@mvanhorn さんに感謝）。AI / 自動化支援 PR 向けのコントリビューターガイドも追加され、安全なローカルチェックと高リスクな broker/MCP/認証情報の領域を整理しています（#173）。

• 2026-06-03 🧹 コミュニティトリアージ + トレース相関: ツール呼び出しのトレースエントリに発信元の call_id が付与され、run トレースの再生時に tool_result を対応する tool_call に突き合わせられます——引数プレビューはトレースファイルを小さく保つため切り詰めたままです（#168、@zwrong さんに感謝）。ソースコードのコメントは、外部コントリビューターが見つけられない内部専用のドキュメントパスを指さなくなりました（#166、@jaleelpersonal さんに感謝）。また、インストール時の langchain-community の依存解決の警告は失敗ではなく残存パッケージによる無害な通知であることを明確化し（#167）、Gemini 2.5/3.0 の関数呼び出しにおける thoughtSignature の往復処理を、完全な修正計画付きの help wanted タスクとして整理しました（#170、@jliu6789 さんに感謝）。

• 2026-06-02 🔌 6 つの新しいブローカー connector（Tiger / Longbridge / Alpaca / OKX / Binance / Futu）: connector-first の取引レイヤーに、IBKR（ローカル）と Robinhood（MCP）に加えて直接 SDK トランスポートが加わりました。各 connector は読み取り専用の account / positions / orders / quote / history に加え、ペーパー口座での発注を公開します——これらのブローカーのペーパー口座で戦略を検証できます。Tiger / Alpaca / OKX / Binance / Futu の 5 つは、Robinhood と同じ安全モデルの背後で、有界かつ mandate でゲートされた発注にも対応します: ユーザーがコミットした mandate（銘柄ユニバース／注文サイズ／エクスポージャー／レバレッジ／日次上限）、ファイルレベルの kill switch、fail-closed の発注前ゲート、完全な監査台帳。Longbridge はペーパー + 読み取り専用のみです（API がランタイムでのペーパー/live 判別子を公開しないため）。すべてのペーパー/live の区別はブローカー単位の構造的ガードです。新しい trading_place_order / trading_cancel_order ツールを追加し、mandate ユニバースに香港株と A 株のアセットクラスを追加しました。実験的 / 自己責任でご利用ください。

• 2026-06-01 🚀 v0.1.9 リリース（pip install -U vibe-trading-ai）: 0.1.8 以降のすべてをまとめました。Connector-first ブローカー profile（IBKR ローカル読み取り専用 TWS / IB Gateway + OAuth・コミット済み mandate・order guard・audit ledger・instant halt の背後にある Robinhood Agentic Trading）。CLI / REST / MCP / Web を貫く Research Goal ランタイム。swarm 強化——live reconcile + MCP keepalive、operator 設定の worker MCP ツール、厳格 alpha-bench ランダムコントロール、失敗/stale run を再実行する新 retry_run（現在 36 MCP tools）。agent/cli/ パッケージ refactor + 刷新したターミナル UI、mootdx トークン不要の A 株 loader、backtest / agent loop / session の堅牢性 pass。--version は常にインストール済みパッケージと一致し、0.1.8 のドリフトを修正（#156）。

• 2026-05-31 🔌 Connector-first ブローカーアーキテクチャ（IBKR + Robinhood）: 取引アクセスは、個別のブローカー入口や live 入口ではなく、選択可能な connector profile から始まるようになりました。vibe-trading connector list/use/check/account/positions/orders/quote/history と MCP の trading_* ツールは同じ選択済み profile を共有し、paper/live は connector 配下の属性として扱われます。IBKR はローカル読み取り専用 TWS / IB Gateway profile ですぐ使え、公式 IBKR リモート MCP は安定した read tool 名が公開されるまで OAuth mcp.read probe として seed されています。Robinhood Agentic Trading は引き続き、OAuth、コミット済み mandate、order guard、audit ledger、instant halt の背後にある bounded live MCP connector です。

• 2026-05-30 🧰 堅牢性パス — backtest、agent loop、session: LLM 生成の signal engine は、インスタンス化の前にインターフェース事前検証を通すようになりました。循環 self-import、generate() の欠落、デフォルト値のない __init__ 引数、誤った戻り値型といった典型ミスを早期に捕捉し、生の traceback ではなく実行可能な JSON エラーで返します (#149)。続くフォローアップで、ソースレベルの AST 検証エラーも同じクリーンな JSON エンベロープに乗せました。agent loop は 50 反復を使い切って出力のない failed 状態に陥らなくなりました——swarm worker の実績ある方式に倣い、反復予算の 80% で wrap-up nudge を注入し、最後の反復で tool 定義を外してテキスト回答を強制します (#148)。途中でのみ発火するようガードしてあり、research-goal の文脈を押しのけることはありません。session のメッセージ書き込みは append ごとに flush + fsync するようになり、高価な AI 応答が書き込み途中のクラッシュでも残ります。読み取り側は壊れた JSONL 行をスキップし（復旧用に先頭 200 文字をログ）、/messages エンドポイント全体を 500 にしません (#147)。Web の入力欄は IME の Enter 処理も修正し、変換確定の Enter で語の途中送信が起きないようにしました (#146)。

• 2026-05-29 🔐 Robinhood Agentic Trading 対応（オプトイン・有界自律）: Robinhood Agentic Trading に対応しました（リモート MCP、OAuth）。デフォルトでは無効かつ読み取り専用。エージェントはユーザーがコミットした mandate（銘柄／注文サイズ／エクスポージャー／レバレッジ／日次上限）の範囲内でのみ自律取引し、ファイルレベルの即時 kill switch、先制的なポジション手仕舞い、mandate の自動失効、完全な監査台帳、永続的な自律 runner を備えます。資金の保管なし・取引所運営なし——資金の保有と執行はブローカーが行い、こちらは意図を中継するだけです。実験的 / 自己責任でご利用ください。

• 2026-05-28 🧪 Swarm の安全性 + 厳格 alpha gate + worker 側 MCP: Swarm DAG は上流タスクが失敗したとき下流タスクをブロックするようになりました (#145)。新規 run_bench_strict() は IC gate に同 universe のランダムコントロール + train/test OOS 分割を追加し、市場 beta を追っているだけの偽 factor を捕捉します (#143, @Soli22de さんに感謝)。Swarm worker は operator が設定した外部 MCP server からツールを呼べるようになり、信頼境界は専用テストで固定されています (#142, @shadowinlife さんに感謝)。

• 2026-05-27 📊 mootdx A 株データソース + 出力スタイル: 新規 mootdx loader はネイティブ 通达信 TCP プロトコルで A 株 OHLCV を取得します（認証不要、IP 速度制限なし、日足 + 分足の 25 ページ walk-back ページング）。fallback chain では tushare と akshare の間に配置されます (#107)。CCXT loader は HTTP_PROXY/HTTPS_PROXY/ALL_PROXY を読み込み、制限されたネットワークから Binance/OKX の公開データを取得できるようになりました (#126, @ruok808 さんに感謝)。最終回答のレンダリングからは CLI と Web の見苦しい全幅 --- セパレータを削除しました: system prompt は markdown table と ## heading を促し、CLI renderer は単独 HR を defense-in-depth として除去し、chat bubble はすり抜けた <hr> を隠します (#139, @sdwxm188 さんに感謝)。

• 2026-05-26 ✅ Research Goal ライフサイクルの閉ループ化: Goal mode が実際のタスクランナーのように動くようになりました。Web UI で goal を作成すると session を作成または bind し、即座に kickoff turn を送ります。active goal は Web/API/CLI/MCP から continue/edit/cancel/complete でき、agent loop は最初の prompt だけでなく現在の goal snapshot（criteria、evidence、claims、open items）から前進します。criteria が covered でも goal が active のままなら silent stop ではなく audit/status update に入り、backend、CLI、MCP、frontend events の回帰で固定しました。

• 2026-05-25 🧼 よりクリーンな Chat UI + composer workflow: Web UI は次の入力に集中できる形になりました。upload、swarm、research-goal mode は composer の + メニューにまとまり、floating panel で会話を邪魔しません。現在の context は input 上の compact chip として表示され、goal details は chip クリック時だけ inline 展開されます。旧 custom i18n layer も削除し、直接 English copy に統一。Full Report card は report-worthy run のみに表示され、local dev startup/status reporting もブラウザ smoke test 向けに安定化しました。

• 2026-05-24 🎯 Research Goal runtime: backend、CLI、API/MCP、SSE、Web UI をまたぐ session-scoped Research Goal layer を追加しました。Goal は claim、acceptance criteria、evidence row、budget、completion policy を永続化します。agent tool は goal 作成と evidence 追加に対応し、/goal が CLI 入口になり、REST/MCP は goal snapshot と evidence write を公開し、SSE は chat client の状態を fresh に保ちます。後続 audit fixes では verified evidence をロックダウンし、agent tool からの live-trading risk tier をブロックし、CLI-created goal を後続 turn に接続し、session 削除時の goal ledger cleanup、replay-all 接続、frontend の cross-session snapshot race 修正を行いました。

• 2026-05-23 🖥️ インタラクティブ CLI の刷新: ターミナル入口は大きな Vibe-Trading バナー、より見やすい prompt 区切り、前ターンの recap、実行後の所要時間、Claude Code 風の activity rail で live agent 作業を表示します。tool call、web/data fetch、shell 風 action、Markdown 回答、pipe table は読みやすい transcript として描画され、pipe や非 TTY 実行では自動化向けの plain-text 出力を維持します。生成 CLI スクリーンショットは committed docs ではなく local artifact として扱い、リポジトリを軽く保ちます。

• 2026-05-22 🧭 Swarm リカバリ + MCP keepalive: Swarm の状態は読み取りのたびに live task ファイルから reconcile されるようになり、API/MCP/SSE/list ビューはクラッシュ済みまたは stale な run を復旧し、永遠に running のスナップショットを見せ続けません。run_swarm は polling 中に MCP progress heartbeat を送り、transport drop 後に再接続するクライアントでも handle を拾えるよう最初のフレームを swarm_started run_id=<id> に固定しました。worker も LLM streaming、grounding fetch、tool execution の各段階で heartbeat を出します。stale-run reaper は run ごとの閾値を使い、task 状態から終端状態を導出します。SwarmTool は待機予算が尽きても進行中の team をキャンセルせず、MCP クライアントは reap_stale_runs() で明示的に cleanup できます。今日の DX pass では provider の既定モデルも更新し、CI syntax check を新しい agent/cli/ パッケージに合わせました。hydrate、終端復旧、stale reap、keepalive cadence、env parsing、heartbeat wiring を 22 件の新規回帰テストでカバーし、swarm/MCP 全体スイートは 169 passed、4 skipped です。

• 2026-05-21 🧱 CLI パッケージリファクタ: agent/cli.py（3216 LOC）を agent/cli/ パッケージへ分割 — インタラクティブな入口、slash ルーター、Rich コンポーネント、そしてすべてのサブコマンドを保ち cli.cmd_* / cli._INIT_ENV_PATH / cli.Confirm などの公開シンボルを再エクスポートする _legacy.py shim。新しい FastAPI ミドルウェアはブラウザが /runs/{id} または /correlation を直接開いた際に SPA シェルを返し、同じ絞り込みを Vite dev プロキシにも反映。バージョン文字列は cli/_version.py で一本化（--version とバナーのドリフト解消）、python -m cli を __main__.py で復活、chat ゲートを絞り chat --help / chat extra は REPL に飲み込まれずレガシー argparse に届きます。

• 2026-05-20 🔬 Hypothesis Registry CLI: 2026-05-16 にバックエンドのみで公開された Hypothesis Registry の CLI 側を完成させました。vibe-trading hypothesis list は Rich テーブルまたは JSON を出力（--status フィルタと --limit をサポート）、show <id> はリンクされた run card を含む詳細パネルを描画、invalidate <id> --note "..." はステータスを rejected に切り替え、--note を省略すると既存の invalidation notes を保持します。既存の VIBE_TRADING_HYPOTHESES_PATH 環境変数オーバーライドに加え、呼び出し単位の --path も使えます。配線、JSON 出力、ステータスフィルタ、limit、ID 不在エラー、ノート永続化を 22 のテストでカバー。

• 2026-05-19 ✨ ツールのライブフィードバック + グレースフルキャンセル: 長時間実行されるツール（バックテスト、大きい PDF、swarm worker）が固まったように見えなくなりました。各ツール呼び出しは 3 秒ごとのハートビートに加え、構造化された段階進捗を発行します — run_backtest はフェーズマーカー（validate / simulate / finalize）、read_document は PDF ではページ単位、Excel ではシート単位、read_url は fetch / parse をマーク。CLI の Rich Live ダッシュボードは Unicode スピナー、ASCII プログレスバー、ETA を描画し、ツール名でキー付けして最大 3 つの並列ツールをスタック表示します。フロントエンドのチャットには新規 ToolProgressIndicator を追加し、rAF コアレッシング、ARIA role="status" + スクリーンリーダー向けの非表示 <progress>、合計が既知の場合は determinate な ProgressRing SVG を備えます。CLI 実行中の最初の Ctrl+C は agent.cancel() を呼んでグレースフル終了（現在のステップが完了し、trace がクリーンに閉じる）し、2 秒以内に 2 度目を押すと強制終了します。再利用可能なプリミティブ ProgressBar.tsx と lib/tools.ts（共有ツール名 i18n マッピング）も抽出。

• 2026-05-18 🧹 クリーンアップ + 3 つの潜在バグ修正: CompositeEngine が取引所サフィックスのない中国先物コード（RB2410 等）を GlobalFuturesEngine に誤ルーティングしていた問題を修正。_is_china_futures を共有の _market_hooks モジュールに移し、製品コード表を大小文字正規化 + 非中国取引所のガードを追加、回帰ケース 9 件を新設しました。session FTS5 インデックスがタイムスタンプを永続化するようになり、クロスセッション検索を日付ソートできるようになりました。同じ修正で、re-upsert 経路が started_at を wall-clock で上書きしていた副次バグも解消しました。Vite 開発プロキシに /alpha を追加し、AlphaZoo ページが npm run dev で解決されるようになりました。tests/test_e2e_harness_v2.py（実 LLM の e2e スイート）は VIBE_TRADING_RUN_LIVE_E2E=1 でゲート化し、CI が環境変数の有無で形を変えないようにしました。ruff に factor zoo 用の per-file-ignores を追加（F401 ノイズ 3783 → 0）、フロントエンド tsconfig は noUnusedLocals / noUnusedParameters を有効化して回帰ガードとし、gtja191 alpha の未使用 vw = vwap(...) 雛形 76 件も削除しました。正味 -918 行。

• 2026-05-17 🧬 Alpha Zoo v1（0.1.8）: 4 つの zoo にまたがる 452 個の事前構築 quant alpha を同梱しました — qlib158（Microsoft Qlib の Alpha158 特徴量、Apache-2.0 出処明示）、alpha101（Kakushadze の "101 Formulaic Alphas" を arXiv:1601.00991 から論文ベースで書き直し）、gtja191（国泰君安 2014 年の短期取引型 alpha レポート）、academic（Fama-French 5 + Carhart 動量の価格ベース proxy 実装）。任意の universe で 1 行 CLI: vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025。AST 純関数ゲート、look-ahead ガードテスト、pytest-socket ネットワーク遮断、各 zoo ごとの LICENSE.md、コミュニティ PR 用の DCO 署名フローも同梱。Alpha Library 自動レンダリングは vibetrading.wiki/alpha-library/、Research Lab には Which of the 191 GTJA alphas still work in 2026? を公開。

• 2026-05-16 🧪 リサーチ基盤アップデート: backend Hypothesis Registry を追加し、create_hypothesis、update_hypothesis、link_backtest、search_hypotheses を提供します。外部コンテンツ reader は warning-only の security_warnings を付与し、Shadow Account scanner は旧 calendar-phase stub から決定的な OHLCV feature evaluation に移行しました。

• 2026-05-15 🪪 Run 詳細ページが metrics と artifacts の隣に Trust Layer の run card を描画するようになり、2026-05-12 に入った run_card.json 側の UI 半分が揃いました。PersistentMemory.add() も #108/#109/#110 の triage を受け、長さ、空・空白だけの name、C0/C1 制御バイトの各経路で強化されました（#112、@Teerapat-Vatpitak に感謝）。

• 2026-05-14 🌐 公開 Wiki が vibetrading.wiki で公開され、docs、tutorials、Research Lab、Alpha Library セクションを Cloudflare Pages から配信します。永続メモリも CLI から vibe-trading memory list/show/search/forget で確認できるようになり（#102、@Teerapat-Vatpitak に感謝）、メモリの tokenization/slug はタイ語、アラビア語、ヘブライ語、キリル文字にも対応しました（#104）。

• 2026-05-13 🧭 Swarm 実行では、取得済みの市場データでワーカーを grounding し、永続化レポートもより整理されました（#93、#84）。

• 2026-05-12 🧾 バックテストは、再現可能なリサーチ実行のために artifacts と並んで run_card.json と run_card.md を出力するようになりました。

• 2026-05-11 🧭 メモリ slug、swarm 集計、CLI プリフライト: 永続メモリのファイル slug 生成で CJK 文字を保持するようになり、中国語/日本語/韓国語ノートの静かなファイル名衝突を防ぎます（#95、@voidborne-d に感謝）。Swarm run の合計は provider が返す token usage を優先し、従来の推定フォールバックも維持します（#94、@Teerapat-Vatpitak に感謝）。CLI run UI には一般的な環境問題を早めに見つける起動時プリフライトチェックも入りました（#96、@ykykj に感謝）。

• 2026-05-10 🧱 回帰ガードレール + run メタデータ: Memory recall はアンダースコアを token 境界として扱うようになり、mcp_wiring_test のような snake_case の保存メモリが "mcp wiring" のような自然言語クエリに一致します（#87、@hp083625 に感謝）。MCP server には initialize → tools/list → tools/call を通す subprocess smoke test を追加し、初回呼び出し deadlock 経路の回帰を防ぎます（#86）。さらに Windows のパス依存テスト、API の best-effort 例外処理、backtest run_dir allowed-root 検証、SwarmRun provider/model メタデータの低リスク強化も入りました（#88、#90、#91、#92、@Teerapat-Vatpitak に感謝）。

• 2026-05-09 🛡️ API パス強化 + MCP server 安定化: API の run/session ルートは参照前にパス ID を検証し、改行を含む不正なパラメータを拒否し、その挙動を auth/security 回帰テストで固定しました（#80、@SJoon99 に感謝）。MCP server は tools/call を処理する前にメインスレッドでツールレジストリを事前ウォームアップし、lazy tool discovery の初回呼び出しデッドロックを回避します（#85、@Teerapat-Vatpitak に感謝）。Vite dev proxy も VITE_API_URL を尊重し、非デフォルトのバックエンドターゲットを使えるようになりました（#82、@voidborne-d に感謝）。

• 2026-05-08 🧾 Tushare 財務諸表フィールドをフィルターへ: A 株の日次バックテストで fundamental_fields から PIT-safe な財務諸表フィールドを要求できるようになり、signal engine は公告/開示日以降に income_total_revenue、income_n_income、balancesheet_total_hldr_eqy_exc_min_int、fina_indicator_roe など表名プレフィックス付き列でスクリーニングできます（#76、@mrbob-git に感謝）。後続の強化により、明示的な財務諸表フィールド要求で Tushare enrichment が失敗した場合は、価格バーだけに静かに戻るのではなく即時失敗します（#77）。

• 2026-05-07 📈 Tushare fundamentals + コミュニティ整理: ファンダメンタル調査ワークフロー向けに point-in-time の TushareFundamentalProvider 契約を追加し、プロジェクトの TUSHARE_TOKEN 環境変数パスを回帰テストでカバーしました（#74）。コミュニティ整理では、Vibe-Trading は当面 UI を単一言語に絞って高速反復すること、DuckDuckGo ベースの web_search が既に同梱されているため重複する検索依存を追加しないこと、非公式ホスト先は API key やデータソース token を入力する信頼済み場所として扱わないことも明確にしました。

• 2026-05-06 🚀 v0.1.7 リリース（Release notes、pip install -U vibe-trading-ai）: セキュリティ境界強化版を PyPI と ClawHub に公開しました。API/読み取り/アップロード/ファイル/URL/生成コード/shell ツール/Docker の既定境界をより安全にしつつ、localhost の CLI/Web UI ワークフローは低摩擦のままです。このサイクルには Web UI Settings、相関ヒートマップ、OpenAI Codex OAuth、A 株 pre-ST フィルター、対話型 CLI UX、swarm preset inspection、配当分析、開発ワークフロー改善、frontend build-dependency floor の監査も含まれます。0.1.7 のコントリビューターと、協調的なセキュリティ検証を行った lemi9090 (S2W) に感謝します。

• 2026-05-05 🛡️ セキュリティ境界の追加強化: 明示的な CORS origins、Settings の認証情報表示、Web URL 読み取り、Shadow Account コード生成まわりの残りのセキュリティ境界を補強し、それぞれに回帰テストを追加しました。通常の localhost CLI/Web UI ワークフローは従来どおりです。リモートデプロイでは引き続き API_AUTH_KEY と明示的な信頼済み origins を設定してください。

• 2026-05-04 🖥️ インタラクティブ CLI UX + CI 整理: インタラクティブモードに、provider/model、セッション時間、直近実行時間、累計ツール呼び出し統計を表示するライブ下部ステータスバーを追加。さらに prompt_toolkit により上下キーの履歴移動と左右キーのカーソル編集に対応しました（#69）。prompt_toolkit または TTY が利用できない場合は、従来どおり Rich prompt にフォールバックします。CI のパス期待値も強化済みファイル import サンドボックスとクロスプラットフォームな /tmp 解決に合わせ、main はグリーンに戻りました（bb67dc7）。

• 2026-05-03 🛡️ セキュリティハードニングパッチ: 非ローカルデプロイ向けの既定 API 認証を強化し、機密性の高い run/session/swarm 読み取りを保護、アップロードとローカルファイル読み取り境界を制限、shell 系ツールをエントリーポイント別に制御、生成戦略を import 前に検証し、Docker イメージは既定で非 root ユーザーかつ localhost 限定ポート公開で動作します。ローカル CLI と localhost Web UI は低摩擦のままです。リモート API/Web デプロイでは API_AUTH_KEY を設定してください。

• 2026-05-02 🧭 配当分析 + ロードマップ刷新: インカム株、配当の持続性、増配、株主還元利回り、権利落ちメカニクス、利回りの罠チェックに対応する dividend-analysis skill を追加し、bundled-skill 回帰テストで固定しました。公開ロードマップは Research Autopilot、Data Bridge、Options Lab、Portfolio Studio、Alpha Zoo、Research Delivery、Trust Layer、Community 共有に絞りました。

• 2026-05-01 🔥 相関ヒートマップ + OpenAI Codex OAuth + A 株 pre-ST フィルター: 新しい相関ダッシュボード/APIでローリングリターン相関を計算し、ポートフォリオや銘柄分析向けに ECharts ヒートマップで可視化します（#64）。OpenAI Codex provider は vibe-trading provider login openai-codex による ChatGPT OAuth に対応し、Settings メタデータとアダプター回帰テストも追加（#65）。A 株の ST/*ST リスクスクリーニング用 ashare-pre-st-filter skill を追加・強化し、Sina 処分公告の関連性フィルターにより証券口座リスト内の言及が E2 回数を水増ししないようにしました（#63）。

• 2026-04-30 ⚙️ Web UI Settings + validation CLI 強化: LLM provider/model、Base URL、reasoning effort、データソース認証情報をローカルで設定できる Settings ページを追加。settings API は local/auth で保護され、provider メタデータもデータ駆動設定に移行しました（#57）。さらに python -m backtest.validation <run_dir> を強化し、引数なし・空パス・不正パス・存在しないパス・ディレクトリでないパスを検証開始前に分かりやすく失敗させます（#60）。

• 2026-04-28 🚀 v0.1.6 リリース（pip install -U vibe-trading-ai）: pip install / uv tool install 後に vibe-trading --swarm-presets が空を返す問題を修正（#55）。プリセット YAML は src.swarm パッケージ内に同梱され、6 件の回帰テストで固定されています。加えて AKShare loader が ETF（510300.SH）と forex（USDCNH）を正しい endpoint にルーティングし、registry fallback も強化しました。v0.1.5 以降の更新を集約: benchmark comparison panel、/upload streaming + size limits、Futu loader（HK + A 株）、vnpy export skill、security hardening、frontend lazy loading（688KB → 262KB）。

• 2026-04-27 📊 ベンチマーク比較パネル + アップロード安全性: バックテスト出力に benchmark comparison panel（ticker / benchmark return / excess return / information ratio）を追加し、yfinance 経由で SPY、CSI 300 などを解決します（#48）。加えて /upload は request body を 1 MB chunks で stream し、MAX_UPLOAD_SIZE 超過時に中断するため、過大/不正な client の下でもメモリを抑えます（#53）。4 ケースの回帰テストで固定されています。

• 2026-04-22 🛡️ ハードニング + 新規連携: safe_path でパス封じ込めを強制し、journal/shadow tool sandbox、MANIFEST.in による .env.example / tests / Docker files の sdist 同梱、route-level lazy loading による frontend 初期 bundle 688KB → 262KB を実施。さらに Futu data loader for HK & A-share equities（#47）と vnpy CtaTemplate export skill（#46）も追加しました。

• 2026-04-21 🛡️ Workspace + docs: 相対 run_dir を active run dir に正規化しました（#43）。README usage examples も追加しました（#45）。

• 2026-04-20 🔌 Reasoning + Swarm: reasoning_content をすべての ChatOpenAI path で保持し、Kimi / DeepSeek / Qwen thinking が end-to-end で動作します（#39）。Swarm streaming と clean Ctrl+C も入りました（#42）。

• 2026-04-19 📦 v0.1.5: PyPI と ClawHub に公開。python-multipart CVE floor bump、新規 MCP tools 5 つ接続（analyze_trade_journal + shadow-account tools 4 つ）、pattern_recognition → pattern registry fix、Docker dep parity、SKILL manifest sync（22 MCP tools / 71 skills）。

• 2026-04-18 👥 Shadow Account: broker journal から strategy rules を抽出 → market 横断で shadow を backtest → 8-section HTML/PDF report で取りこぼし（rule violations、early exits、missed signals、counterfactual trades）を正確に可視化。新規 tools 4 つ、skill 1 つ、合計 32 tools。Trade Journal + Shadow Account samples も Web UI welcome screen に追加されました。

• 2026-04-17 📊 Trade Journal Analyzer + Universal File Reader: broker exports（同花順/東財/富途/generic CSV）を upload → auto trading profile（holding days、win rate、PnL ratio、drawdown）+ 4 bias diagnostics（disposition effect、overtrading、chasing momentum、anchoring）。read_document は PDF、Word、Excel、PowerPoint、images（OCR）、40+ text formats を 1 つの unified call に dispatch します。

• 2026-04-16 🧠 Agent Harness: Persistent cross-session memory、FTS5 session search、self-evolving skills（full CRUD）、5-layer context compression、read/write tool batching。27 tools、107 new tests。

• 2026-04-15 🤖 Z.ai + MiniMax: Z.ai provider（#35）、MiniMax temperature fix + model update（#33）。13 providers。

• 2026-04-14 🔧 MCP Stability: stdio transport 上の backtest tool Connection closed error を修正しました（#32）。

• 2026-04-13 🌐 Cross-Market Composite Backtest: 新しい CompositeEngine が mixed-market portfolios（例: A-shares + crypto）を shared capital pool と per-market rules で backtest します。swarm template variable fallback と frontend timeout も修正しました。

• 2026-04-12 🌍 Multi-Platform Export: /pine が strategies を TradingView（Pine Script v6）、TDX（通达信/同花顺/东方财富）、MetaTrader 5（MQL5）へ 1 コマンドで export します。

• 2026-04-11 🛡️ Reliability & DX: vibe-trading init .env bootstrap（#19）、preflight checks、runtime data-source fallback、hardened backtest engine。Multi-language README（#21）。

• 2026-04-10 📦 v0.1.4: Docker fix（#8）、web_search MCP tool、12 LLM providers、akshare/ccxt deps。PyPI と ClawHub に公開。

• 2026-04-09 📊 Backtest Wave 2: ChinaFutures、GlobalFutures、Forex、Options v2 engines。Monte Carlo、Bootstrap CI、Walk-Forward validation。

• 2026-04-08 🔧 Multi-market backtest with per-market rules、Pine Script v6 export、5 data sources with auto-fallback。

---

✨ 主な機能

🔍 自己改善型トレーディングエージェント • 自然言語による市場リサーチ • 戦略ドラフトとファイル/Web 分析 • メモリに支えられたワークフロー	🐝 マルチエージェント・トレーディングチーム • 投資、クオンツ、暗号資産、リスクの各チーム • 進捗ストリーミングと永続化レポート • 取得済み市場データで grounding されたワーカー
📊 クロスマーケットデータ & バックテスト • A/HK/US 株式、暗号資産、先物、FX • データフォールバックと複合バックテスト • PIT データ、検証、run cards	👥 Shadow Account • ブローカー取引日誌の行動診断 • ルールベースの Shadow Account 比較 • エクスポート可能な監査レポートと戦略コード

💡 Vibe-Trading とは？

Vibe-Trading は、金融に関する問いを実行可能な分析へ変換するためのオープンソースのリサーチワークスペースです。自然言語プロンプトを、市場データ loader、戦略生成、バックテストエンジン、レポート、エクスポート、永続リサーチメモリへ接続します。

研究、シミュレーション、バックテストのために設計されています——さらに、お望みであれば、ご自身が認可したブローカー（例: Robinhood Agentic Trading）を通じた自律取引も可能です。資金は一切保管せず、設定した制限を超える取引は決して行わず、いつでも即座に停止できます。

---

✨ できること

タスク	出力
トレーディングの問いを投げる	ツール、データ、ドキュメント、再利用可能なセッション文脈を使った市場リサーチ。
戦略アイデアをバックテストする	戦略コード、指標、ベンチマーク文脈、検証 artifacts、run cards。
自分の取引をレビューする	ブローカー取引日誌の解析、行動診断、ルール抽出、Shadow Account 比較。
反復リサーチを改善する	永続メモリと編集可能な skills により、有用な手順を再利用可能なワークフローへ変換。
アナリストチームを走らせる	投資、クオンツ、暗号資産、マクロ、リスクのワークフロー向けマルチエージェント・リサーチレビュー。
リサーチを IM チャンネルへ接続する	WebSocket、Telegram、Slack、Discord、Matrix、WhatsApp、Signal、QQ/NapCat、WeChat/WeCom、Feishu/Lark、DingTalk、Teams、email、Mochat から同じ session runtime を CLI、REST、Web UI で管理。
使える artifacts を出力する	レポート、TradingView Pine Script、TDX、MetaTrader 5、MCP tools、後続リサーチセッション。
事前構築 alpha zoo をベンチ	456 個の alpha 因子（Qlib 158 + Kakushadze 101 + GTJA 191 + FF5 + Carhart）に対し、1 行 CLI で IC + IR + alive/reversed/dead 分類を実行

---

⚡ クイック例

pip install vibe-trading-ai

# 自然言語リサーチ
vibe-trading run -p "Backtest a BTC-USDT 20/50 moving-average strategy for 2024, summarize return and drawdown, then export the report"

# 事前構築 alpha zoo を 1 行でベンチ
vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025 --top 20

vibe-trading --upload trades_export.csv
vibe-trading run -p "Analyze my trading behavior, extract my shadow strategy, and compare it with my actual trades"

---

👥 Shadow Account

Shadow Account は、汎用的な戦略テンプレートではなく、あなた自身の取引記録から始めます。

ブローカー export をアップロードし、エージェントに行動を要約させたうえで、実際の取引経路をルールベースの shadow strategy と比較します。

ステップ	エージェントの出力
1. 取引日誌を読む	同花順、东方财富、富途、generic CSV 形式のブローカー export を解析します。
2. 行動をプロファイルする	保有日数、勝率、PnL ratio、drawdown、disposition effect、overtrading、momentum chasing、anchoring checks。
3. ルールを抽出する	繰り返し現れる entries/exits を、曖昧な要約ではなく明示的な strategy profile に変換します。
4. shadow を実行する	抽出したルールをバックテストし、rule breaks、early exits、missed signals、alternative trade paths を強調します。
5. レポートを届ける	後から確認、アーカイブ、または次回セッションで改善できる HTML/PDF report を生成します。

vibe-trading --upload trades_export.csv
vibe-trading run -p "Analyze my trading behavior, extract my shadow strategy, and compare it with my actual trades"

---

🧪 リサーチワークフロー

多くの実行は、同じ evidence path をたどります。リクエストを routing し、適切な市場文脈を読み込み、ツールを実行し、出力を検証し、artifacts を確認可能な形で残します。

レイヤー	何が起きるか
Plan	必要な finance skills、tools、data sources、必要に応じて swarm preset を選びます。
Ground	A 株、HK/US 株式、暗号資産、先物、FX、documents、Web context を利用可能な loaders から取得します。
Execute	テスト可能な strategy code を生成し、tools を実行し、対応する backtest engine または analysis workflow を使います。
Validate	metrics、benchmark comparison、Monte Carlo、Bootstrap、Walk-Forward、run cards、必要な warnings を追加します。
Deliver	TradingView、TDX、MetaTrader 5、MCP clients、後続セッション向けの reports、artifacts、tool traces、exports を返します。

---

📡 データソースとスマートフォールバック

1 回の get_market_data 呼び出しで 18 のマーケットデータソースにアクセスできます。source: "auto" を指定すれば、loader が銘柄に応じてソースを選び、IP 規制リスクの順に並んだ市場別チェーンをたどります。規制を受けない公開ソースを先に、スロットリングや key を要するソースを最後に試します。設定不要、単一障害点なし。

Source	Markets	Auth	Role
tencent · mootdx	A-share	none	never IP-banned (mootdx = 通达信 TCP)
eastmoney	A / US / HK	none	OHLCV + deep fundamentals & flow tools (throttled)
baostock · akshare	A (+ US/HK/futures/macro/fx)	none	free fallbacks
tushare	A / futures / fund / macro	token	richest A-share
yahoo · sina · stooq	US (/HK)	none	direct chart/quotes/options · K-line to 1984 · EOD CSV
yfinance	US / HK	none	wrapper
finnhub · alphavantage · tiingo · fmp	US	key	optional providers
okx · ccxt	crypto	none	OKX + 100+ exchanges
futu	HK / A	OpenD	optional local FutuOpenD
local	any	none	your own CSV / Parquet / DuckDB via local: prefix

フォールバックチェーン（IP 規制リスク順）：

• A 株 → tencent · mootdx · eastmoney · baostock · akshare · tushare · local
• 米国株 → yahoo · stooq · sina · eastmoney · yfinance · tiingo · fmp · finnhub · alphavantage · akshare · local
• 香港株 → eastmoney · yahoo · futu · yfinance · akshare · local
• 暗号資産 → okx · ccxt · yfinance · local  ·  (先物 / ファンド / マクロ / FX → tushare/akshare → local)

OHLCV にとどまらず、18 の読み取り専用データツールがファンダメンタルズと資金フローまで踏み込みます。資金フロー、龍虎榜、北向資金、信用取引、大口取引、株主数、ロックアップ、セクター、調査レポート、ニュース、SEC filings、財務諸表、オプションチェーン、機関投資家保有、市場スクリーニング、銘柄検索、マクロまで、すべて MCP 経由で公開されます。明示的な local: 銘柄が暗黙のうちにネットワークソースへフォールバックすることは決してありません。

---

🔩 詳細な機能

メイン README を読みやすく保つため、詳細な一覧は以下に折りたたんでいます。利用できる構成要素を確認したいときに開いてください。

Finance Skill Library _{8カテゴリにわたる79 skills}

• 📊 79 の金融特化 skills を 8 カテゴリに整理
• 🌐 伝統的市場から crypto & DeFi まで完全カバー
• 🔬 データ取得からクオンツリサーチまでを横断する包括的能力

Category	Skills	Examples
Data Source	9	data-routing, tushare, yfinance, okx-market, akshare, mootdx, ccxt, eastmoney, sec-edgar
Strategy	17	strategy-generate, cross-market-strategy, technical-basic, candlestick, ichimoku, elliott-wave, smc, multi-factor, ml-strategy
Analysis	17	factor-research, macro-analysis, global-macro, valuation-model, earnings-forecast, credit-analysis, dividend-analysis
Asset Class	9	options-strategy, options-advanced, convertible-bond, etf-analysis, asset-allocation, sector-rotation
Crypto	7	perp-funding-basis, liquidation-heatmap, stablecoin-flow, defi-yield, onchain-analysis
Flow	7	hk-connect-flow, us-etf-flow, edgar-sec-filings, financial-statement, adr-hshare
Tool	11	backtest-diagnose, report-generate, pine-script, doc-reader, web-reader, vnpy-export, alpha-zoo
Risk Analysis	1	ashare-pre-st-filter

カスタムデータソース _{独自の過去 OHLCV loader を登録}

loader を同梱していない市場やベンダーが必要ですか？独自の過去バー loader を追加し、 source="<name>" で選択できます。以下の手順はパッケージのソースを編集するため、 clone から実行してください（pip install -e .）。

1. loader を書く —— agent/backtest/loaders/<name>_loader.py を作成し、 DataLoaderProtocol を満たすクラス（duck-typed、基底クラス不要）を定義して @register を付けます：

   import pandas as pd
   from backtest.loaders.registry import register
   
   @register
   class DataLoader:
       name = "mysource"            # the value you pass as source=
       markets = {"us_equity"}      # a_share/us_equity/hk_equity/crypto/futures/fund/macro/forex
       requires_auth = False
   
       def is_available(self) -> bool:
           return True              # token present? network reachable?
   
       def fetch(self, codes, start_date, end_date, *, interval="1D", fields=None):
           # return {symbol: DataFrame indexed by trade_date,
           #         columns: open, high, low, close, volume}
           ...
   

2. モジュールを登録 して @register を発火させる —— agent/backtest/loaders/registry.py の _loader_modules に "backtest.loaders.<name>_loader" を追加します。

3. 名前を許可 して設定バリデーションを通す —— agent/backtest/runner.py の _VALID_SOURCES に "mysource" を追加します。

4. （任意） registry.py のある市場の FALLBACK_CHAINS に組み込むと、 source="auto" からも到達できます。

5. 使う —— バックテスト設定で source="mysource"、または CLI / agent 経由で。

リアルタイムの ticks / 板情報（depth）は loader の対象外です —— loader 層は point-in-time の過去バーのみを扱います。リアルタイム市場データは broker connector を通します：暗号資産は okx / binance / ccxt、株式は futu / tiger。

Preset Trading Teams _{29 swarm presets}

• 🏢 すぐ使える 29 の agent teams
• ⚡ 事前構成済みの finance workflows
• 🎯 投資、トレーディング、リスク管理向け presets

Preset	Workflow
investment_committee	Bull/bear debate → risk review → PM final call
global_equities_desk	A-share + HK/US + crypto researcher → global strategist
crypto_trading_desk	Funding/basis + liquidation + flow → risk manager
earnings_research_desk	Fundamental + revision + options → earnings strategist
macro_rates_fx_desk	Rates + FX + commodity → macro PM
quant_strategy_desk	Screening + factor research → backtest → risk audit
technical_analysis_panel	Classic TA + Ichimoku + harmonic + Elliott + SMC → consensus
risk_committee	Drawdown + tail risk + regime review → sign-off
global_allocation_committee	A-shares + crypto + HK/US → cross-market allocation

_{さらに 20 以上の specialist presets があります。すべて確認するには vibe-trading --swarm-presets を実行してください。}

Alpha Zoo _{4 つの zoo に渡る 456 個の事前構築 quant alpha}

• 🧬 456 個のクロスセクショナル alpha、オペレーター層でルックアヘッドを禁止
• 📈 IC + IR + alive/reversed/dead 分類を 1 つの CLI コマンドで
• 🔬 AST 純関数ゲート + 300 行のルックアヘッド sentinel テスト + pytest-socket によるネットワーク遮断
• 📦 Qlib には Apache-2 帰属表示、各 zoo ごとに LICENSE.md で formula を数学的内容として宣言
• 🤝 コミュニティ PR 向け Developer Certificate of Origin (DCO) 署名フロー

Zoo	件数	出典	ライセンス
qlib158	154	Microsoft Qlib Alpha158（Apache-2.0、コミット固定）	Apache-2.0
alpha101	101	Kakushadze (2015)、"101 Formulaic Alphas"、arXiv:1601.00991	Formula は数学的内容
gtja191	191	国泰君安 (2014)、「191 短周期取引型 alpha 因子」	Formula は数学的内容
academic	10	Fama-French 5 + Carhart momentum（価格ベースの proxy） + Jegadeesh reversal + George-Hwang 52-week-high + Amihud illiquidity + Harvey-Siddique skew	公開された学術文献

vibe-trading alpha list で閲覧、vibe-trading alpha show <id> で formula + ソース、vibe-trading alpha bench --zoo X --universe Y --period Z で zoo 全体をスコアリングできます。

🎬 デモ

https://github.com/user-attachments/assets/4e4dcb80-7358-4b9a-92f0-1e29612e6e86	https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30
☝️ 自然言語バックテスト & マルチエージェント swarm debate — Web UI + CLI

---

🚀 クイックスタート

1行インストール（PyPI）

pip install vibe-trading-ai

最初のリサーチタスクを実行します。

vibe-trading init
vibe-trading run -p "Backtest a BTC-USDT 20/50 moving-average strategy for 2024 and summarize return and drawdown"

古いバージョンからのアップグレード？ 0.1.10 で LangChain 1.x に移行しました。0.1.10 より前のインストールに対して pip install -U vibe-trading-ai を実行した後にインポートが壊れる場合（例: langgraph のインポート失敗）、venv を作り直すか pip install --force-reinstall vibe-trading-ai を実行してください。新規インストールは影響を受けません。

Package name vs commands: PyPI package は vibe-trading-ai です。インストール後、3 つのコマンドが使えます。

Command	Purpose
vibe-trading	Interactive CLI / TUI
vibe-trading serve	FastAPI web server を起動
vibe-trading-mcp	MCP server を起動（Claude Desktop、OpenClaw、Cursor など向け）

vibe-trading init              # interactive .env setup
vibe-trading                   # launch CLI
vibe-trading serve --port 8899 # launch web UI
vibe-trading-mcp               # start MCP server (stdio)

または利用経路を選ぶ

Path	Best for	Time
A. Docker	すぐ試す、ローカル設定ゼロ	2 min
B. Local install	開発、CLI へのフルアクセス	5 min
C. MCP plugin	既存 agent へ接続	3 min
D. ClawHub	clone 不要、1 コマンド	1 min

前提条件

• 対応 provider の LLM API key、または Ollama によるローカル実行（key 不要）
• Path B では Python 3.11+
• Path A では Docker
• OpenAI Codex は ChatGPT OAuth でも利用できます。LANGCHAIN_PROVIDER=openai-codex を設定し、vibe-trading provider login openai-codex を実行してください。OPENAI_API_KEY は使いません。

Supported LLM providers: OpenRouter、OpenAI、DeepSeek、Gemini、Groq、DashScope/Qwen、Zhipu、Moonshot/Kimi、MiniMax、Xiaomi MIMO、Z.ai、Ollama（local）。設定は .env.example を参照してください。

Tip: 自動フォールバックにより、すべての市場は API key なしで利用できます。yfinance（HK/US）、OKX（crypto）、mootdx（A 株、TCP 直結で IP 制限なし）、AKShare（A-shares、US、HK、futures、forex）はすべて無料です。Tushare token は任意で、A 株は mootdx が推奨の no-token fallback、AKShare がより広いカバレッジのバックアップになります。

Path A: Docker（設定ゼロ）

git clone https://github.com/HKUDS/Vibe-Trading.git
cd Vibe-Trading
cp agent/.env.example agent/.env
# Edit agent/.env — uncomment your LLM provider and set API key
docker compose up --build

http://localhost:8899 を開きます。Backend + frontend が 1 つの container で動作します。

Docker は既定で backend を 127.0.0.1:8899 に公開し、app を non-root container user として実行します。意図して API を自分の machine 外へ公開する場合は、強い API_AUTH_KEY を設定し、client から Authorization: Bearer <key> を送ってください。

Path B: Local install

git clone https://github.com/HKUDS/Vibe-Trading.git
cd Vibe-Trading
python -m venv .venv

# Activate
source .venv/bin/activate          # Linux / macOS
# .venv\Scripts\Activate.ps1       # Windows PowerShell

pip install -e .
cp agent/.env.example agent/.env   # Edit — set your LLM provider API key
vibe-trading                       # Launch interactive TUI

Web UI を起動（任意）

# Terminal 1: API server
vibe-trading serve --port 8899

# Terminal 2: Frontend dev server
cd frontend && npm install && npm run dev

http://localhost:5899 を開きます。frontend は API calls を localhost:8899 へ proxy します。

Production mode（single server）:

cd frontend && npm run build && cd ..
vibe-trading serve --port 8899     # FastAPI serves dist/ as static files

Note

vibe-trading serve は 0.0.0.0 にバインドしますが、デフォルトではループバックのみを信頼します。同じマシンで UI を開く場合（http://localhost:8899）は設定不要で動作します。別のマシン・VM ホスト・LAN 上のスマートフォンからアクセスすると、機微なエンドポイントは 403 を返し、チャットに “Remote API access requires an API key” と表示されます。agent/.env に強力な API_AUTH_KEY を設定して再起動し、Settings で同じキーを入力してください。（Docker Desktop のホストゲートウェイの場合: デフォルトの 127.0.0.1 ポートバインドのまま VIBE_TRADING_TRUST_DOCKER_LOOPBACK=1 を設定。）

Path C: MCP plugin

下の MCP Plugin セクションを参照してください。

Path D: ClawHub（1 コマンド）

npx clawhub@latest install vibe-trading --force

skill + MCP config が agent の skills directory にダウンロードされます。詳細は ClawHub install を参照してください。

---

🧠 環境変数

agent/.env.example を agent/.env にコピーし、使いたい provider block のコメントを外してください。各 provider には 3-4 個の変数が必要です。

Variable	Required	Description
LANGCHAIN_PROVIDER	Yes	Provider name（openrouter, deepseek, groq, ollama など）
<PROVIDER>_API_KEY	Yes*	API key（OPENROUTER_API_KEY, DEEPSEEK_API_KEY など）
<PROVIDER>_BASE_URL	Yes	API endpoint URL
LANGCHAIN_MODEL_NAME	Yes	Model name（例: deepseek-v4-pro）
TUSHARE_TOKEN	No	A-share data 用 Tushare Pro token（AKShare に fallback）
TIMEOUT_SECONDS	No	LLM call timeout、既定 120s
API_AUTH_KEY	Recommended for network deployments	API が非ローカル client から到達可能な場合に必要な Bearer token
VIBE_TRADING_ENABLE_SHELL_TOOLS	No	remote API/MCP-SSE style deployments で shell-capable tools を明示 opt-in
VIBE_TRADING_ALLOWED_FILE_ROOTS	No	document と broker-journal imports 用の追加 comma-separated roots
VIBE_TRADING_ALLOWED_RUN_ROOTS	No	generated-code run directories 用の追加 comma-separated roots

_{* Ollama は API key 不要です。OpenAI Codex は ChatGPT OAuth を使い、tokens は agent/.env ではなく oauth-cli-kit 経由で保存します。}

無料データ（key 不要）: AKShare による A-shares、yfinance による HK/US equities、OKX による crypto、CCXT による 100+ crypto exchanges。システムは各市場に最適な利用可能 source を自動選択します。

🎯 推奨モデル

Vibe-Trading は tool-heavy agent です。skills、backtests、memory、swarms はすべて tool calls を通じて流れます。モデル選択は、agent が実際に tools を使う か、training data から作り話をするかを直接左右します。

Tier	Examples	When to use
Best	anthropic/claude-opus-4.7, anthropic/claude-sonnet-4.6, openai/gpt-5.5-pro, google/gemini-3.5-flash	複雑な swarms（3+ agents）、長い research sessions、paper-grade analysis
Sweet spot (default)	deepseek-v4-pro, deepseek/deepseek-v4-pro, x-ai/grok-4.20, z-ai/glm-5.1, moonshotai/kimi-k2.6, qwen/qwen3-max-thinking	日常使い。信頼できる tool-calling を約 1/10 の cost で
Avoid for agent use	*-nano, *-flash-lite, *-coder-next, small / distilled variants	Tool-calling が不安定です。agent は skills 読み込みや backtests 実行ではなく「記憶から答えている」ように見えます

既定の agent/.env.example は DeepSeek official API + deepseek-v4-pro で出荷されています。OpenRouter users は deepseek/deepseek-v4-pro を利用できます。

---

🖥 CLI リファレンス

vibe-trading               # interactive TUI
vibe-trading run -p "..."  # single run
vibe-trading serve         # API server
vibe-trading alpha list    # 456 個の事前構築 alpha を閲覧；show / bench / compare / export-manifest サブコマンド利用可
vibe-trading channels status --local  # IM チャンネル設定と install hints を確認

TUI 内の slash commands

Command	Description
/help	全コマンドを表示
/skills	79 finance skills を一覧表示
/swarm	29 swarm team presets を一覧表示
/swarm run <preset> [vars_json]	live streaming で swarm team を実行
/swarm list	Swarm run history
/swarm show <run_id>	Swarm run details
/swarm cancel <run_id>	実行中の swarm をキャンセル
/list	Recent runs
/show <run_id>	Run details + metrics
/code <run_id>	生成された strategy code
/pine <run_id>	indicators を export（TradingView + TDX + MT5）
/trace <run_id>	Full execution replay
/continue <run_id> <prompt>	新しい指示で run を継続
/sessions	Chat sessions を一覧表示
/settings	Runtime config を表示
/clear	画面をクリア
/quit	終了

Single run & flags

vibe-trading run -p "Backtest BTC-USDT MACD strategy, last 30 days"
vibe-trading run -p "Analyze AAPL momentum" --json
vibe-trading run -f strategy.txt
echo "Backtest 000001.SZ RSI" | vibe-trading run

vibe-trading -p "your prompt"
vibe-trading --skills
vibe-trading --swarm-presets
vibe-trading --swarm-run investment_committee '{"topic":"BTC outlook"}'
vibe-trading --list
vibe-trading --show <run_id>
vibe-trading --code <run_id>
vibe-trading --pine <run_id>           # Export indicators (TradingView + TDX + MT5)
vibe-trading --trace <run_id>
vibe-trading --continue <run_id> "refine the strategy"
vibe-trading --upload report.pdf
vibe-trading alpha list --zoo gtja191 --limit 10
vibe-trading alpha show gtja191_171
vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025 --top 20

IM チャンネル

IM channel adapters は外部チャットアプリを Web UI / CLI と同じ session runtime へ接続します。有効化する adapter は ~/.vibe-trading/agent.json の channels 配下に設定します。SDK-backed adapters は optional extras で、SDK が足りない場合も runtime を落とさず recovery hints を返します。

vibe-trading channels status --local   # API なしで config と missing SDK hints を確認
vibe-trading channels status           # 稼働中の API runtime を問い合わせ
vibe-trading channels start            # API 経由で enabled adapters を開始
vibe-trading channels stop             # API 経由で enabled adapters を停止
vibe-trading channels login weixin     # 必要な adapter login hook を実行
vibe-trading channels pairing --channel telegram list

Built-in adapters は websocket、telegram、slack、discord、matrix、whatsapp、signal、qq、napcat、weixin、wecom、feishu、dingtalk、msteams、email、mochat です。個別に pip install "vibe-trading-ai[telegram]" を使うか、全チャンネル分を pip install "vibe-trading-ai[channels]" で入れられます。

チャット内スラッシュコマンド（チャンネル非依存、全 16 adapter で共通）：

コマンド	説明
/new	現在のセッションをリセット——次のメッセージで新しい会話を開始
/reset	/new のエイリアス
/newsession	/new のエイリアス
/pairing list	保留中の sender pairing リクエストを表示

コマンドは大文字小文字を区別せず、メッセージ全体として送信する必要があります（例：hello /new はリセットではなく通常メッセージとして処理されます）。

---

💡 例

Strategy & Backtesting

# Moving average crossover on US equities
vibe-trading run -p "Backtest a 20/50-day moving average crossover on AAPL for the past year, show Sharpe ratio and max drawdown"

# RSI mean-reversion on crypto
vibe-trading run -p "Test RSI(14) mean-reversion on BTC-USDT: buy below 30, sell above 70, last 6 months"

# Multi-factor strategy on A-shares
vibe-trading run -p "Backtest a momentum + value + quality multi-factor strategy on CSI 300 constituents over 2 years"

# After backtesting, export to TradingView / TDX / MetaTrader 5
vibe-trading --pine <run_id>

事前構築 alpha zoo を 1 行でベンチ:

vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025 --top 20

カタログを閲覧して個別の alpha を確認:

vibe-trading alpha list --zoo gtja191 --theme reversal --limit 10
vibe-trading alpha show gtja191_171

zoo からマルチファクターシグナルを構成（Python）:

from src.skills.multi_factor.zoo_signal_engine import ZooSignalEngine
engine = ZooSignalEngine.from_zoo(["gtja191_171", "gtja191_111", "gtja191_163"])
panel = ...  # your wide OHLCV panel
signal = engine.compute_signal(panel)

Market Research

# Equity deep-dive
vibe-trading run -p "Research NVDA: earnings trend, analyst consensus, option flow, and key risks for next quarter"

# Macro analysis
vibe-trading run -p "Analyze the current Fed rate path, USD strength, and impact on EM equities and gold"

# Crypto on-chain
vibe-trading run -p "Deep dive BTC on-chain: whale flows, exchange balances, miner activity, and funding rates"

Swarm Workflows

# Bull/bear debate on a stock
vibe-trading --swarm-run investment_committee '{"topic": "Is TSLA a buy at current levels?"}'

# Quant strategy from screening to backtest
vibe-trading --swarm-run quant_strategy_desk '{"universe": "S&P 500", "horizon": "3 months"}'

# Crypto desk: funding + liquidation + flow → risk manager
vibe-trading --swarm-run crypto_trading_desk '{"asset": "ETH-USDT", "timeframe": "1w"}'

# Global macro portfolio allocation
vibe-trading --swarm-run macro_rates_fx_desk '{"focus": "Fed pivot impact on EM bonds"}'

Cross-Session Memory

# Save your preferences once
vibe-trading run -p "Remember: I prefer RSI-based strategies, max 10% drawdown, hold period 5–20 days"

# The agent recalls them in future sessions automatically
vibe-trading run -p "Build a crypto strategy that fits my risk profile"

Upload & Analyze Documents

# Analyze a broker export or earnings report
vibe-trading --upload trades_export.csv
vibe-trading run -p "Profile my trading behavior and identify any biases"

vibe-trading --upload NVDA_Q1_earnings.pdf
vibe-trading run -p "Summarize the key risks and beats/misses from this earnings report"

---

🌐 API サーバー

vibe-trading serve --port 8899

Method	Endpoint	Description
GET	/runs	runs を一覧表示
GET	/runs/{run_id}	run details
GET	/runs/{run_id}/pine	Multi-platform indicator export
POST	/sessions	session を作成
POST	/sessions/{id}/messages	message を送信
GET	/sessions/{id}/events	SSE event stream
POST	/upload	PDF/file をアップロード
GET	/swarm/presets	swarm presets を一覧表示
POST	/swarm/runs	swarm run を開始
GET	/swarm/runs/{id}/events	Swarm SSE stream
GET	/alpha/list	zoo/theme/universe でフィルタした alpha リスト
GET	/alpha/{alpha_id}	Alpha のメタデータ + ソースコード
POST	/alpha/bench	Bench ジョブを開始（job_id を返す）
GET	/alpha/bench/{job_id}/stream	SSE 進捗ストリーム
GET	/settings/llm	Web UI LLM settings を読み取り
PUT	/settings/llm	local LLM settings を更新
GET	/settings/data-sources	local data source settings を読み取り
PUT	/settings/data-sources	local data source settings を更新
GET	/channels/status	IM channel runtime と adapter status を読み取り
POST	/channels/start	設定済み IM channel adapters を開始
POST	/channels/stop	設定済み IM channel adapters を停止
POST	/channels/pairing/command	shared store に対して sender-pairing command を実行
POST	/scheduled-runs	定期リサーチジョブを作成（interval-ms または cron）
GET	/scheduled-runs	スケジュール済みジョブを一覧
DELETE	/scheduled-runs/{job_id}	スケジュール済みジョブをキャンセル

Interactive docs: http://localhost:8899/docs

Security defaults

localhost 開発では、vibe-trading serve は browser workflow を簡単に保ちます。非ローカル client では、sensitive API endpoints に API_AUTH_KEY が必要です。JSON/upload requests には Authorization: Bearer <key> を使ってください。Browser EventSource streams は、Settings で同じ key を一度入力した後、Web UI が処理します。

Shell-capable tools は local CLI と trusted localhost workflows で利用できますが、VIBE_TRADING_ENABLE_SHELL_TOOLS=1 を明示的に設定しない限り remote API sessions には公開されません。Document と journal readers は既定で upload/import roots に制限されます。ファイルは agent/uploads、agent/runs、./uploads、./data、~/.vibe-trading/uploads、~/.vibe-trading/imports の下に置くか、VIBE_TRADING_ALLOWED_FILE_ROOTS で専用 directory を追加してください。

Web UI Settings

Web UI Settings page では、local users が LLM provider/model、base URL、generation parameters、reasoning effort、Tushare token など任意の market data credentials を更新できます。Settings は agent/.env に永続化され、provider defaults は agent/src/providers/llm_providers.json から読み込まれます。

Settings reads は side-effect free です。GET /settings/llm と GET /settings/data-sources は agent/.env を作成せず、project-relative paths だけを返します。Settings の読み書きは credential state の公開や credentials/runtime environment の更新を伴うため、設定済みの場合は API_AUTH_KEY が必要です。dev mode で API_AUTH_KEY が未設定の場合、settings access は loopback clients からのみ受け付けます。

同じ Settings page には local operator 向けの IM チャンネルパネルもあります。/channels/status を polling し、configured/enabled/available/loaded/running 状態、adapter recovery hints、runtime の start/stop 操作を terminal に戻らず扱えます。

Scheduled research（定期リサーチ）

リサーチ prompt や backtest を繰り返しスケジュールで実行します。バックグラウンド executor は既定でオフです。VIBE_TRADING_ENABLE_SCHEDULER=1 を付けて server を起動すると有効になります:

VIBE_TRADING_ENABLE_SCHEDULER=1 vibe-trading serve --port 8899

その後、REST でジョブを作成します。schedule は単なる整数（interval はミリ秒）か、5 フィールドの cron 式（分 時 日 月 曜日）です:

# 6 時間ごと（cron）
curl -X POST http://localhost:8899/scheduled-runs \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Scan CSI300 for momentum breakouts and backtest the top 5","schedule":"0 */6 * * *"}'

# 一覧 / キャンセル
curl http://localhost:8899/scheduled-runs
curl -X DELETE http://localhost:8899/scheduled-runs/<job_id>

各実行は新しい agent session で prompt を実行し（任意の backtest パラメータは config に入れます）、ジョブは ~/.vibe-trading/ に永続化されるため再起動後も残ります。このフラグがない場合、/scheduled-runs endpoints はジョブを記録しますが実行はされません。API_AUTH_KEY を設定している場合は各呼び出しに -H "Authorization: Bearer <key>" を付けてください。

---

🔌 MCP Plugin

Vibe-Trading は MCP-compatible client 向けに 54 MCP tools を公開します。stdio subprocess として動作し、server setup は不要です。Core research tools は HK/US/crypto で API key なしに動作し、trading connector tools は選択中の connector profile を使います。LLM key が必要なのは run_swarm のみです。

Claude Desktop

claude_desktop_config.json に追加:

{
  "mcpServers": {
    "vibe-trading": {
      "command": "vibe-trading-mcp"
    }
  }
}

OpenClaw

~/.openclaw/config.yaml に追加:

skills:
  - name: vibe-trading
    command: vibe-trading-mcp

Cursor / Windsurf / other MCP clients

vibe-trading-mcp                  # stdio (default)
vibe-trading-mcp --transport sse  # SSE for web clients

公開される MCP tools（54）: list_skills, load_skill, start_research_goal, get_research_goal, add_goal_evidence, update_research_goal_status, backtest, factor_analysis, analyze_options, pattern_recognition, read_url, read_document, web_search, write_file, read_file, list_swarm_presets, run_swarm, get_market_data, get_fund_flow, get_dragon_tiger, get_northbound_flow, get_margin_trading, get_block_trades, get_shareholder_count, get_lockup_expiry, get_sector_info, get_research_reports, get_stock_news, get_sec_filings, get_financial_statements, get_options_chain, get_stock_profile, screen_market, search_symbol, get_macro_series, iwencai_search, get_swarm_status, get_run_result, list_runs, reap_stale_runs, retry_run, analyze_trade_journal, extract_shadow_strategy, run_shadow_backtest, render_shadow_report, scan_shadow_signals, trading_connections, trading_select_connection, trading_check, trading_account, trading_positions, trading_orders, trading_quote, trading_history.

ClawHub からインストール（1 コマンド）

npx clawhub@latest install vibe-trading --force

--force が必要なのは、skill が external APIs を参照し、VirusTotal の automated scan が起動するためです。コードは完全に open-source で、自由に確認できます。

これにより skill + MCP config が agent の skills directory にダウンロードされます。clone は不要です。

ClawHub で見る: clawhub.ai/skills/vibe-trading

OpenSpace — self-evolving skills

79 の finance skills はすべて open-space.cloud に公開され、OpenSpace の self-evolution engine を通じて自律的に進化します。

OpenSpace と使うには、agent config に両方の MCP servers を追加してください。

{
  "mcpServers": {
    "openspace": {
      "command": "openspace-mcp",
      "toolTimeout": 600,
      "env": {
        "OPENSPACE_HOST_SKILL_DIRS": "/path/to/vibe-trading/agent/src/skills",
        "OPENSPACE_WORKSPACE": "/path/to/OpenSpace"
      }
    },
    "vibe-trading": {
      "command": "vibe-trading-mcp"
    }
  }
}

OpenSpace は 79 skills を自動検出し、auto-fix、auto-improve、community sharing を可能にします。OpenSpace-connected agent では search_skills("finance backtest") から Vibe-Trading skills を検索できます。

---

📁 プロジェクト構成

クリックして展開

Vibe-Trading/
├── agent/                          # バックエンド (Python)
│   ├── cli/                        # CLI パッケージ — インタラクティブ TUI + サブコマンド
│   ├── api_server.py               # FastAPI サーバー — runs、sessions、upload、swarm、SSE
│   ├── mcp_server.py               # MCP サーバー — OpenClaw / Claude Desktop 向け 54 tools
│   │
│   ├── src/
│   │   ├── agent/                  # ReAct エージェントコア
│   │   │   ├── loop.py             #   5 層コンテキスト圧縮 + read/write ツールバッチング
│   │   │   ├── context.py          #   システムプロンプト + 永続メモリからの自動 recall
│   │   │   ├── skills.py           #   skill ローダー（79 個同梱 + CRUD でユーザー作成）
│   │   │   ├── tools.py            #   ツール基底クラス + レジストリ
│   │   │   ├── memory.py           #   run ごとの軽量ワークスペース状態
│   │   │   ├── frontmatter.py      #   共有 YAML frontmatter パーサー
│   │   │   └── trace.py            #   実行トレースライター
│   │   │
│   │   ├── memory/                 # クロスセッション永続メモリ
│   │   │   └── persistent.py       #   ファイルベースメモリ (~/.vibe-trading/memory/)
│   │   │
│   │   ├── tools/                  # 68 個の自動検出エージェントツール
│   │   │   ├── backtest_tool.py    #   バックテスト実行
│   │   │   ├── remember_tool.py    #   クロスセッションメモリ (save/recall/forget)
│   │   │   ├── skill_writer_tool.py #  skill CRUD (save/patch/delete/file)
│   │   │   ├── session_search_tool.py # FTS5 クロスセッション検索
│   │   │   ├── swarm_tool.py       #   swarm チームを起動
│   │   │   ├── web_search_tool.py  #   DuckDuckGo Web 検索
│   │   │   └── ...                 #   bash、file I/O、factor analysis、options、alpha browser + bench など
│   │   │
│   │   ├── factors/                # Alpha Zoo — 4 つの zoo にまたがる 456 個の alpha
│   │   │   ├── base.py             #   19 個のオペレーター (rank/scale/ts_*/delta/decay_linear/safe_div/vwap)
│   │   │   ├── registry.py         #   AST 限定のメタデータ読み込み + 遅延計算 + sanity gate
│   │   │   ├── bench_runner.py     #   IC + alive/reversed/dead 分類
│   │   │   └── zoo/                #   qlib158 (154) + alpha101 (101) + gtja191 (191) + academic (10)
│   │   │
│   │   ├── api/                    # FastAPI ルートモジュール
│   │   │   └── alpha_routes.py     #   /alpha/list、/alpha/{id}、/alpha/bench、SSE ストリーム
│   │   │
│   │   ├── skills/                 # 8 カテゴリ 79 個の finance skills（各 SKILL.md）
│   │   ├── swarm/                  # Swarm DAG 実行エンジン
│   │   │   └── presets/            #   29 個の swarm preset YAML 定義
│   │   ├── session/                # マルチターンチャット + FTS5 セッション検索
│   │   └── providers/              # LLM プロバイダー抽象化
│   │
│   └── backtest/                   # バックテストエンジン
│       ├── engines/                #   7 エンジン + クロスマーケット composite engine + options_portfolio
│       ├── loaders/                #   18 ソース: tushare、okx、yfinance、akshare、baostock、tencent、mootdx、ccxt、futu、local、eastmoney、sina、stooq、yahoo、finnhub、alphavantage、tiingo、fmp
│       │   ├── base.py             #   DataLoader Protocol
│       │   └── registry.py         #   Registry + 自動フォールバックチェーン
│       └── optimizers/             #   MVO、equal vol、max div、risk parity
│
├── frontend/                       # Web UI (React 19 + Vite + TypeScript)
│   └── src/
│       ├── pages/                  #   Home、Agent、AlphaZoo、RunDetail、Compare、Correlation、Settings
│       ├── components/             #   chat、charts、layout
│       └── stores/                 #   Zustand 状態管理
│
├── Dockerfile                      # マルチステージビルド
├── docker-compose.yml              # 1 コマンドデプロイ
├── pyproject.toml                  # パッケージ設定 + CLI エントリポイント
├── tools/                          # リポジトリレベルの CI ヘルパー
│   └── ci_grep_gates.sh            # yaml.load / 商標 / 銘柄データ漏洩を拒否
└── LICENSE                         # MIT

---

🏛 エコシステム

Vibe-Trading は HKUDS agent ecosystem の一部です。

HKUDS Agents Open Agent Infrastructure

AI-Trader Agent-Native Signal & Copy Trading Platform

CLI-Anything Making All Software Agent-Native

OpenSpace Self-Evolving AI Agent Skills

ClawTeam Agent Swarm Intelligence

---

🗺 ロードマップ

段階的に出荷します。作業が始まった項目は Issues に移動します。

Phase	Feature	Status
Trust Layer	再現可能な run cards は出力・Run Detail 表示まで完了。v1 では tool traces と citations を追加	v0 出荷済み
Hypothesis Registry	lifecycle status、data sources、skills、run-card links、invalidation notes を持つ永続リサーチ仮説	Backend MVP 出荷済み
Research Autopilot	手動実行から始める research loop: hypothesis → deterministic backtest → evidence report	フェーズ1–3 出荷済み
Data Bridge	Bring-your-own data: local CSV/Parquet/SQL connectors with schema mapping	ローカルローダー出荷済み
Options Lab	Vol surface, Greeks dashboard, payoff/scenario explorer	Planned
Portfolio Studio	Risk x-ray, constraints, turnover-aware optimizer, rebalance notes	Planned
Alpha Zoo	452 個の事前構築 alpha 因子（Qlib 158 + Kakushadze 101 + GTJA 191 + FF5 + Carhart）、1 行 CLI でベンチ、agent 統合、Web UI	0.1.8 でリリース済み
Research Delivery	Slack / Telegram / email-style IM channels 経由の scheduled briefs と live research sessions	スケジューラ + IM Runtime 出荷済み
Community	Shareable skills, presets, and strategy cards	Exploring

---

Contributing

Contributions を歓迎します。ガイドラインは CONTRIBUTING.md を参照してください。

Good first issues は good first issue でタグ付けされています。気になるものから始めてください。

より大きな貢献を検討している場合は、上の Roadmap を確認し、着手前に issue を開いて相談してください。

---

Contributors

Vibe-Trading に貢献してくださった皆さまに感謝します。

最近の v0.1.10 cycle contributors and credits:

• @Hinotoi-agent — a security-hardening wave: local-shutdown auth (#241), loopback-host rebinding rejection (#242), agent shell-tool opt-in (#243), settings-write auth (#245), mandate proposal-id containment (#256), persistent-memory type validation (#257), and MCP swarm run-id containment (#258)
• @mvanhorn — the opt-in local data cache (#177), Gemini thoughtSignature round-trip over OpenAI-compat tool calls (#176), the custom data loader guide (#194), and the glm/zhipu provider alias + model-name inference (#247)
• @gyx09212214-prog — loader robustness for malformed crypto/RSSHub timeout env vars (#227, #240), requested yfinance end-date inclusion (#226), strict run-card JSON for non-finite metrics (#238), and ddgs retry-fallback coverage (#239)
• @BillDin — swarm agent status in the chat UI (#188), explicit preset-name handling (#189), the loader-backed market-data tool for swarm workers (#199), and preset-context continuations (#200)
• @Robin1987China — the Research Autopilot goal-hypothesis bridge (#260), the local CSV/Parquet/DuckDB data loader (#252), and an assistant-prefill fix + configurable Kimi User-Agent (#248)
• @LemonCANDY42 — the read-only runtime status dashboard (#210), persisted AgentLoop usage artifacts (#223), and opt-in Run Detail chart payloads (#225)
• @zwrong — the trace.jsonl overhaul with zero truncation + offload (#206) and session-id on exit + resume <session-id> (#218)
• @forge-builder — the AI contributor guide (#173) and the OpenClaw MCP research-only smoke-test docs (#165)
• @skloxo — Chinese (zh-CN) frontend localization (adopted from #217)
• @LeeCQiang — Chinese docstrings across all 452 Alpha Zoo factors (#180)
• @KaiLuettmann — GHCR pre-built image publishing on release (#187)
• @ngoanpv — Gemini thought_signature preservation through the AgentLoop dict path (#184)
• @ShahNewazKhan — Docker host-Ollama reachability via host.docker.internal (#196)
• @sambazhu — frontend sync of completed chat attempts (#236)
• @bhlt — baostock-native code format support (#230)
• @octo-patch — MiniMax M3 default model upgrade (#162)
• @warren618 / Haozhe Wu — the global data layer (8 sources + 18 read-only data tools), the 10 broker SDK connectors, the alpha-compare full stack, the provider-reliability overhaul, multi-engine web_search fallback, responsive Stop + SSE reconnect, and release integration

---

Disclaimer

Vibe-Trading は研究・取引ソフトウェアです。投資助言ではなく、資金を一切保管せず、取引所も運営しません。取引はご自身が明示的に認可したブローカーチャネル（例: Robinhood Agentic Trading）を通じてのみ行われ、設定した制限の範囲内で、いつでも停止できます。このブローカー取引機能は実験的であり、当方が実際のブローカー口座で検証したものではありません——自己責任でご利用ください。過去の成績は将来の結果を保証しません。

License

MIT License — see LICENSE

---

Star History

⭐ Vibe-Trading が研究の役に立ったら、Star を付けると他の人にも見つけてもらえます。

---

Vibe-Trading をご覧いただきありがとうございます ✨