English | 中文 | 日本語 | 한국어 | العربية | Español | Bahasa Indonesia

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

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

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

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

` または接続センター）、既定の口座にフォールバックしません。株式ポジションは気配値の対応付けが済むまで評価額なしで表示され、オプション・暗号資産・先物・イベント契約・投資信託・債券も保有する口座は、株式だけの表示ではなくソースのエラーになります。 | 挙動 | 得られるもの | |------|--------------| | **ソースごとの出所** | すべての保有がどの接続由来かを示し、USD で評価して CNY 換算も表示します。 | | **失敗したソースは除外** | エラーになったソースはエラーとして報告され、合計から除外されます（前回値の引き継ぎはしません）。スナップショットは incomplete として記録されます。 | | **不変スナップショット** | 各 refresh は `~/.vibe-trading/portfolio/portfolio.sqlite3` に保存され、認証情報を含まない設定は `~/.vibe-trading/portfolio.json` と `connections.json` に置かれます。 | | **エクスポートと分析** | CSV エクスポートに加え、サニタイズ済みの `portfolio_summary` エージェントツールを提供します。その `risk_xray_args` はそのまま `portfolio_risk_xray` に渡せます。同じスナップショットは `vibe-trading portfolio show` でターミナルにも表示できます（`refresh` / `sources` も同様）。 | 自分でインストールする読み取り専用 connector は checkout の外、`~/.vibe-trading/connectors//` に置かれます。`connector.json` manifest と、`check_status` / `get_account_snapshot` / `get_positions` を実装する `adapter.py` だけです。書き込み系の capability を宣言した manifest は拒否されます。 ```bash vibe-trading connector init my-broker --destination /tmp vibe-trading connector validate /tmp/my-broker vibe-trading connector install /tmp/my-broker ``` 認証情報は `pip install "vibe-trading-ai[keyring]"` により OS の keyring（macOS Keychain、Windows Credential Manager、Linux Secret Service）へ保存され、設定ファイルには入りません。この経路からは注文の発注も取消もできません。 --- ## 🧪 リサーチワークフロー 多くの実行は、同じ 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` 呼び出しで **28 のマーケットデータソース**（うち **QVeris** はオプションの有料マーケットプレイス）にアクセスできます。`source: "auto"` を指定すれば、loader が銘柄に応じてソースを選び、**IP 規制リスク**の順に並んだ市場別チェーンをたどります。規制を受けない公開ソースを先に、スロットリングや key を要するソースを最後に試します。設定不要、単一障害点なし。 | Source | Markets | Auth | Role | |--------|---------|------|------| | `tencent` · `mootdx` | A-share + HK | 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 / HK / futures / fund / macro | token | richest A-share | | `gildata` | A-share | token (Settings / `GILDATA_TOKEN`) | Hundsun Juyuan (恒生聚源) commercial feed — forward-adjusted dailies, joins the A-share chain tail | | `yahoo` | US / HK / カナダ / 英国 | none | direct chart/quotes/options；TSX `.TO` / TSXV `.V`；LSE `.L` は明示通貨で正規化 | | `sina` · `stooq` | US | none | K-line to 1984 · EOD CSV | | `yfinance` | US / HK / カナダ / 英国 | none | wrapper；TSX `.TO` / TSXV `.V`；LSE `.L` は同じ GBP/GBp 契約に従う | | `longbridge` | US / HK | App Key + App Secret + Access Token | optional historical OHLCV source; install the optional SDK | | `finnhub` · `alphavantage` · `tiingo` · `fmp` | US | key | optional providers | | `qveris` | グローバル・マルチアセット | key · credits | **プレミアムマーケットプレイス** — 1つの key で 63+ providers（明示指定のみ、auto フォールバック対象外） | | `nobitex` · `wallex` | 暗号資産（イラン・トマン建てペア） | なし | 公開 UDF エンドポイント。**明示指定のみ** — トマン建ての唯一の供給元であり、USD 建て系列が代役になりうる crypto チェーンには決して加わりません | | `okx` · `ccxt` · `binance` | crypto | none | OKX + 100+ exchanges + Binance historical / USD-M perps | | `futu` | HK / A | OpenD | optional local FutuOpenD | | `mt5` | forex / metals | MT5 terminal | MetaTrader 5 (Exness-style) forex / metal bars, 1m–1D | | `tickerall` | forex / metals | key + アカウント（読み取り専用） | 同じブローカーの MT5 フィードを**ホスト型**で — ローカル端末不要、OS を問わない（明示指定のみ、auto フォールバックには決して入らない） | | `pykrx` | 韓国（KRX：KOSPI/KOSDAQ） | 不要 | `.KS` / `.KQ` の KOSPI / KOSDAQ 日足（任意の `krx` extra） | | `india_broker` | インド（NSE/BSE） | ブローカーログイン | `.NS` / `.BO` 向けの読み取り専用 Zerodha / Shoonya / Dhan bars（フォールバックチェーン末尾） | | `local` | any | none | your own CSV / Parquet / DuckDB via `local:` prefix | **フォールバックチェーン（IP 規制リスク順）：** - **A 株** → `tencent` · `mootdx` · `eastmoney` · `baostock` · `akshare` · `tushare` · `gildata` · `local` - **米国株** → `yahoo` · `stooq` · `sina` · `eastmoney` · `yfinance` · `tiingo` · `fmp` · `finnhub` · `alphavantage` · `longbridge` · `akshare` · `local` - **香港株** → `tencent` · `eastmoney` · `yahoo` · `futu` · `akshare` · `yfinance` · `tushare` · `longbridge` · `local` - **インド株（NSE/BSE）** → `yahoo` · `yfinance` · `india_broker` · `local` - **韓国（KOSPI/KOSDAQ）** → `pykrx` · `yahoo` · `yfinance` · `local` - **英国（LSE）** → `yahoo` · `yfinance` · `local` *（GBP/GBp と明示されたクォートのみ）* - **暗号資産** → `okx` · `ccxt` · `binance` · `yfinance` · `local` - **為替/貴金属** → `mt5` · `yfinance` · `akshare` · `local`  ·  *(先物 / ファンド / マクロ → `tushare`/`akshare` → `local`)* ### Longbridge を明示的に使う Longbridge は米国株/香港株のヒストリカル OHLCV を提供する任意の loader です。SDK のインストール： ```bash pip install "vibe-trading-ai[longbridge]" ``` `.env` に 3 つの認証情報を設定します： ```dotenv LONGBRIDGE_APP_KEY=... LONGBRIDGE_APP_SECRET=... LONGBRIDGE_ACCESS_TOKEN=... ``` バックテストでは `config.json` の `source` を指定します： ```json { "codes": ["QQQ.US"], "start_date": "2025-01-01", "end_date": "2025-01-10", "interval": "1D", "source": "longbridge" } ``` Agent との対話では明示的に依頼してください：**「Longbridge を使って QQQ.US のヒストリカルデータを取得して」**。この明示指定は `source: "auto"` とは別物で、`auto` は市場ごとの通常のフォールバックチェーンをそのまま使います。 OHLCV にとどまらず、**22 の読み取り専用データツール**がファンダメンタルズと資金フローまで踏み込みます。資金フロー、龍虎榜、北向資金、信用取引、大口取引、株主数、ロックアップ、セクター、調査レポート、ニュース、SEC filings、財務諸表、オプションチェーン、銘柄プロファイル、市場スクリーニング、銘柄検索、マクロ、問財、機関投資家保有（13F）、ETF ルックスルー、予測市場、論文検索まで、すべて MCP 経由で公開されます。明示的な `local:` 銘柄が暗黙のうちにネットワークソースへフォールバックすることは決してありません。 ### 💎 オプションのプレミアムデータ — QVeris **データは無料ルーティングが標準、必要なときだけプレミアム。** 既定では 23 の内蔵ソースが自動フォールバックし、key も費用も不要です。QVeris を使うと、63+ providers と 10,000+ capabilities（per QVeris）で、オプション Greeks、高度なファンダメンタルズ、中国・香港・グローバルデータ、マクロ、暗号資産、ニュース、filings を補えます。失敗した call は課金されません。Settings → QVeris または `vibe-trading data mode paid` で有効化できます。 *QVeris disclosure: [Vibe-Trading の紹介リンク](https://qveris.ai/?ref=Vyjjo5G_1cAHJA) から登録すると **+1,000 クレジット** が追加付与され、プロジェクトの支援にもなります。* --- ## 🔩 詳細な機能 メイン README を読みやすく保つため、詳細な一覧は以下に折りたたんでいます。利用できる構成要素を確認したいときに開いてください。

Finance Skill Library _{9カテゴリにわたる90 skills}

- 📊 90 の金融特化 skills を 9 カテゴリに整理 - 🌐 伝統的市場から crypto & DeFi まで完全カバー - 🔬 データ取得からクオンツリサーチまでを横断する包括的能力 | Category | Skills | Examples | |----------|--------|----------| | Data Source | 10 | `data-routing`, `tushare`, `yfinance`, `okx-market`, `akshare`, `mootdx`, `ccxt`, `eastmoney`, `sec-edgar`, `qveris` | | Strategy | 19 | `strategy-generate`, `cross-market-strategy`, `technical-basic`, `candlestick`, `ichimoku`, `elliott-wave`, `smc`, `multi-factor`, `ml-strategy` | | Analysis | 23 | `factor-research`, `correlation-regime`, `macro-analysis`, `global-macro`, `valuation-model`, `investor-lenses`, `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 | 8 | `hk-connect-flow`, `us-etf-flow`, `edgar-sec-filings`, `financial-statement`, `adr-hshare` | | Tool | 10 | `backtest-diagnose`, `report-generate`, `pine-script`, `doc-reader`, `web-reader`, `vnpy-export`, `trade-journal` | | Research | 3 | `alpha-zoo`, `strategy-dev-manager`, `strategy-discovery` | | Risk Analysis | 1 | `ashare-pre-st-filter` |

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

loader を同梱していない市場やベンダーが必要ですか？独自の過去バー loader を追加し、 `source=""` で選択できます。以下の手順はパッケージのソースを編集するため、 clone から実行してください（`pip install -e .`）。 1. **loader を書く** —— `agent/backtest/loaders/_loader.py` を作成し、 `DataLoaderProtocol` を満たすクラス（duck-typed、基底クラス不要）を定義して `@register` を付けます： ```python 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._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`。

ブローカー connectors _{18 ブローカー — read + paper、対応先では bounded-live}

connector-first のプロファイル。多くは read + ペーパー口座での発注に対応します —— IBKR は読み取り専用、Robinhood はライブのみ（ペーパー口座なし）、Scalable Capital は読み取り専用（ペーパー口座が存在しません）、Trading 212 と Toss Securities はペーパーを含め発注を一切拒否します。ライブ発注はユーザーが定義した mandate（銘柄許可リスト、発注サイズ / エクスポージャー上限、1 日の取引回数上限、即時 kill switch）で制限され、資金を預かることは一切ありません —— 執行するのはブローカーです。発注系ツールは MCP に公開されません（agent + CLI のみ）。リサーチ / バックテスト経路は構造的にあらゆるライブ endpoint から遮断されています。 | Broker | Markets | Capabilities | |--------|---------|--------------| | **IBKR** | global | local TWS / Gateway, read-only | | **Robinhood** | US | Agentic MCP (desktop OAuth) — read + bounded live | | **Scalable Capital** | DE / EU | Agentic MCP (desktop OAuth) — 完全読み取り専用、ペーパー口座なし | | **Tiger** | US / HK / A | read + paper + bounded live | | **Alpaca** | US | read + paper + bounded live (+ TAP credential-isolation mode) | | **OKX** · **Binance** | crypto | read + paper + bounded live | | **Futu** | HK / US / A | read + paper + bounded live | | **eToro** | global | read + paper + bounded live（Public API；demo キーは構造上 `/demo` パスにしか到達せず、コピートレードのワークフローにも対応） | | **MetaTrader 5** | forex / CFD | read + paper + bounded live (Exness-style; demo ⇔ paper identity guard) | | **KIS**（韓国投資証券） | 韓国 (KOSPI/KOSDAQ) | read + 本物のペーパー（모의투자、別ホストの本物のブローカー側サンドボックス）—— このマーケットのライブ発注は未対応 | | **Longbridge** · **Dhan** · **Shoonya** · **Zerodha** · **Upbit** | US / HK · India (NSE/BSE) · Korea (crypto) | read + paper only — no runtime paper/live discriminator, so live order placement is hard-refused | | **Trading 212** · **Toss Securities** | UK / EU · Korea/US | fully read-only — `place_order` / `cancel_order` hard-refuse even paper (no verified sandbox) | Paper-vs-live is a **structural per-broker runtime guard** (account-id format, host separation, demo flag, or trade environment), never a config flag the agent can flip. A broker exposing no such discriminator is capped at paper + read-only.

Preset Trading Teams _{30 swarm presets}

- 🏢 すぐ使える 30 の 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 _{5 つのファミリーに渡る 462 個の事前構築 quant alpha}

- 🧬 462 個のクロスセクショナル 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** | 12 | Fama-French 5 + Carhart momentum（価格ベースの proxy） + Jegadeesh reversal + George-Hwang 52-week-high + Amihud illiquidity + Harvey-Siddique skew + Frazzini-Pedersen betting-against-beta + correlation-rewiring stability | 公開された学術文献 | | **fundamental** | 4 | PIT セーフな SEC company facts — earnings yield、ROE、gross profitability、asset growth（filed-date 基準） | 公開財務データ | `vibe-trading alpha list` で閲覧、`vibe-trading alpha show ` で formula + ソース、`vibe-trading alpha bench --zoo X --universe Y --period Z` で zoo 全体をスコアリング、`vibe-trading alpha compare --all` で zoo 同士を並べてランク付けできます。

Backtest Engines _{10 engines + options portfolio, cross-market composite}

| Engine | Market | Notes | |--------|--------|-------| | **ChinaA** | A-share | T+1, price limits, pre-ST filter | | **GlobalEquity** | US / HK / カナダ / 英国 | 同一セッション売買、市場別のロット・呼値・決済通貨・コスト | | **IndiaEquity** | India (NSE/BSE) | T+1, circuit bands, config-driven STT / stamp / SEBI / GST cost stack | | **KoreaEquity** | 韓国（KRX：KOSPI/KOSDAQ） | ロングオンリー、統一呼値グリッド上で ±30% 制限値幅を約定時点に判定、2026 年 0.20% の証券取引税 | | **VietnamEquity** | ベトナム（HOSE） | ロングオンリー、T+2 決済ホールド、10/50/100 ドンの呼値グリッド上で ±7% 制限値幅、100 株単元、売却側 0.1% 課税 | | **Crypto** | crypto spot / USD-M perps | funding settlements, execution/mark split | | **ChinaFutures** · **GlobalFutures** | futures | margin, contract multipliers | | **Forex** | FX / metals | via the `mt5` loader | | **Composite** | cross-market | one shared capital pool across markets (`source="auto"`) | | **options_portfolio** | options | multi-leg, Greeks, payoff/scenario | Intraday bars: 1m / 5m / 15m / 30m / 1H / 4H / 1D. 15 metrics + benchmark comparison, **5 portfolio optimizers** (equal-volatility / risk-parity / mean-variance / max-diversification / turnover-aware), and 3 validation tools (Monte Carlo / Bootstrap / Walk-Forward).

Quant Library _{23 モジュール・306 個のテスト済み関数、すべての経路から呼び出し可能}

`src/quantlib` は、agent が必要とする金融数学のそれぞれについて、テスト済みの実装を **1 つだけ**保持します。skill はこれらを **import** するようになり、markdown コード ブロックの中に数式を抱え込むことはなくなりました —— `SKILL.md` の中に価格式が住んで いたら、それはパターンではなくバグです。 | モジュール | カバー範囲 | |-----------|-----------| | `options` | Black-Scholes 価格 + greeks、インプライドボラティリティの逆算 | | `fixedincome` | 債券数学、Nelson-Siegel / Svensson カーブフィッティング | | `credit` | Altman Z-score、Merton / KMV デフォルト距離 | | `timeseries` | 定常性、共和分、GARCH、bootstrap | | `risk` · `var_backtest` | VaR / CVaR / EVT とそのバックテスト | | `attribution` | Brinson-Fachler 要因分解 | | `performance` · `fundmath` | TWR / MWR / Modified Dietz、XIRR / MOIC / DPI / TVPI | | `factormodel` · `eventstudy` | ファクター回帰、イベントスタディ | | `multipletesting` · `crossvalidation` | 多重検定調整、purged CV | | `impact` | マーケットインパクトモデル | | `volatility` | Heston (1993) 確率的ボラティリティ価格付け | | `portfolio` | 階層的リスクパリティ（HRP）配分 | | `copula` | ガウス・アルキメデス型コピュラ | | `microstructure` | VPIN、Roll スプレッド、Amihud 非流動性、Kyle ラムダ | 読み取り専用の `quantlib_call` ツールが 1 つの契約で全体に到達するため、`bash` が 無効化されている CLI・Web UI・REST API・MCP でも金融数学が使えます。構造的に shell では **ありません** —— モジュール許可リスト、`__all__` のみのディスパッチ、`export_*` は拒否。 計量経済学の関数は `stats` エクストラ（`pip install "vibe-trading-ai[stats]"`）が必要で、 遅延インポートして不足しているものを名指しします。

バリュエーションと機関投資家向けリサーチ _{DCF・コンプス・三表連動、および六つのリサーチコマンド}

入力を自分で捏造することを拒むバリュエーションエンジンです。`contracts.py` の唯一の ルール：**入力が欠けているモデルは実行不能（NOT RUNNABLE）であり、黙ってデフォルト値 を埋めることはない** —— バリュエーションモデルにおけるあらゆるデフォルト値は、定数の 衣をまとった意見だからです。 | モデル | 押さえておくべき挙動 | |--------|---------------------| | `run_dcf` | FCFF ブリッジ、WACC 構築、期央割引、ネットデット・ブリッジ、WACC×g 感応度グリッド。デュアル・ターミナルバリュー：各手法を相手方の含意マルチプルと含意 g で相互検証 | | `run_comps` | EV ブリッジ、LTM + 暦年カレンダリゼーション、マルチプル行列。分母が非正のピアは**除外して報告**し、負のマルチプルとして平均に混ぜません | | `threestatement` | 連動予測。厳格なバランス検証、明示的なリボルバー・プラグ、収束しなければ raise する金利↔負債の循環反復 | 成果物は入力ハッシュ付きでバージョン管理され、xlsx / pptx にエクスポートできます。 6 つのスラッシュコマンドがワークフローを駆動します —— `/comps` `/dcf` `/attrib` `/memo` `/earnings` `/screen` —— それぞれが手順スケルトンと**算術的に整合した** ワークトサンプルを備えています（Brinson 分解はアクティブリターンに厳密に合算され、 業績ブリッジは EPS 差分に厳密に合算されます）。`investor-lenses` skill は著名投資家の 思考フレームワークを分析オーバーレイとして重ねます：各レンズは優先シグナル・失格条件・ 典型的な誤用からなる運用手順であり、人物伝ではなく、ツール名も指定しません。 バー以外に、`src/entities` が不規則な日付のキャッシュフロー（NAV、キャピタルコール、 クーポン）を取り込み、`cashflow_performance` が XIRR / MOIC / DPI / TVPI / TWR / Modified Dietz / MWR を返します。この経路はバーエンジンとあえて**並行**に設計されており、 `nav` 列がバーエンジンに届いて終値として値付けされることは決してありません。

ガバナンスと監査証跡 _{「その数字はどの方法論が生んだのか？」に答える}

すべての実行は、プロンプト・skill の内容・ツールレジストリ・パッケージバージョンを ハッシュした **manifest** を書き出します。1 か月前に出た数字も、それを生んだ正確な 方法論まで遡れます。 **監査台帳**は各レコードを直前のハッシュに連鎖させて fsync するため、レコードの改変や 削除は検出可能です —— 自分のハッシュを再計算した改変であっても、次のレコードで `prev_hash_mismatch` として捕捉されます。タイムスタンプは常に呼び出し側が供給し、 このモジュールは `datetime.now()` を呼びません。 トレースの秘匿は **sink 単位**です：ツール呼び出しの引数とライブ監査台帳は fail-closed sink を使い `content` を秘匿したまま、ツール結果の sink だけが `content` を 解放し、その文字列リーフをパターン洗浄します。`env` はどちらでも解放されません。

## 🎬 デモ

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） ```bash pip install vibe-trading-ai ``` 最初のリサーチタスクを実行します。 ```bash 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 など向け） | ```bash 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、Anthropic（ネイティブ Messages API）、DeepSeek、Gemini、Groq、DashScope/Qwen、Zhipu、Moonshot/Kimi、MiniMax、SiliconFlow（CN + Global）、Xiaomi MIMO、Novita AI、iFlytek Spark、Z.ai、NVIDIA NIM、ModelScope、GitHub Copilot、Ollama（local）。`*_BASE_URL` が未設定の場合、各プロバイダーは canonical なエンドポイントにフォールバックするため、key だけで十分です。設定は `.env.example` を参照してください。 > **Tip:** 自動フォールバックにより、すべての市場は API key なしで利用できます。yfinance/Yahoo（HK/US/カナダ/英国）、OKX（crypto）、mootdx（A 株、TCP 直結で IP 制限なし）、AKShare（A-shares、US、HK、futures、forex）はすべて無料です。LSE `.L` クォートは GBP または GBp の明示が必要で、GBP 会計の前にペンスを正規化します。Tushare token は任意で、A 株は mootdx が推奨の no-token fallback、AKShare がより広いカバレッジのバックアップになります。 ### Path A: Docker（設定ゼロ） ```bash 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 ` を送ってください。 ### Path B: Local install ```bash 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.bat # Windows CMD # .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 ``` > [!NOTE] > **Windows の場合:** `cp` は PowerShell では `Copy-Item` のエイリアスなので、上記のコマンドは PowerShell ならそのまま動きます。CMD には `cp` がないため、代わりに `copy agent\.env.example agent\.env` を使ってください（上の Docker のコマンドも同様です）。PowerShell が `Activate.ps1` の実行を拒否する場合は、先に `Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned` を実行してください。この設定は現在のシェルセッションにのみ適用されます。

Web UI を起動（任意）

```bash # Terminal 1: API server vibe-trading serve --port 8899 # Terminal 2: Frontend dev server cd frontend && npm install && npm run dev # Node >= 22.22 が必要 ``` `http://localhost:5899` を開きます。frontend は API calls を `localhost:8899` へ proxy します。 **Production mode（single server）:** ```bash 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](#-mcp-plugin) セクションを参照してください。 ### Path D: ClawHub（1 コマンド） ```bash npx clawhub@latest install vibe-trading --force ``` skill + MCP config が agent の skills directory にダウンロードされます。詳細は [ClawHub install](#-mcp-plugin) を参照してください。 --- ## 🧠 環境変数 `agent/.env.example` を `agent/.env` にコピーし、使いたい provider block のコメントを外してください。各 provider には 3-4 個の変数が必要です。 | Variable | Required | Description | |----------|:--------:|-------------| | `LANGCHAIN_PROVIDER` | Yes | Provider name（`openrouter`, `deepseek`, `groq`, `ollama` など） | | `_API_KEY` | Yes* | API key（`OPENROUTER_API_KEY`, `DEEPSEEK_API_KEY` など） | | `_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 | | `VIBE_TW_STOCK_DB` | No | 台湾市場の SQLite スナップショットのパス。読み取り専用 `taiwan_stock_data` ツールはスキーマ妥当な場合のみ登録されます | | `VIBE_TRADING_EXTRA_CORS_ORIGINS` | No | ループバックの CORS 既定値に**追加**するオリジン（カンマ区切り。`CORS_ORIGINS` は置き換え） | | `CONTENT_FILTER_WARNING_THRESHOLD` | No | コンテンツフィルタ警告の比率しきい値（既定 0.05 = 5%）。コンテンツモデレーションでブロックされた LLM 応答の割合がこれを超えると、run card がプロバイダーの変更を促します。 | _{* Ollama は API key 不要です。OpenAI Codex は ChatGPT OAuth を使い、tokens は `agent/.env` ではなく `oauth-cli-kit` 経由で保存します。} **無料データ（key 不要）:** AKShare による A-shares、Yahoo/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 で | | **agent 用途では避ける** | `*-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 リファレンス ```bash vibe-trading # interactive TUI vibe-trading run -p "..." # single run vibe-trading serve # API server vibe-trading alpha list # 462 個の事前構築 alpha を閲覧；show / bench / compare / export-manifest サブコマンド利用可 vibe-trading playbook list # 定期リサーチのテンプレート 5 本；show / create サブコマンド利用可 vibe-trading channels status --local # IM チャンネル設定と install hints を確認 vibe-trading provider doctor # 秘匿処理済みの provider/proxy/package 診断を出力 ```

TUI 内の slash commands

| Command | Description | |---------|-------------| | `/help` | キーボードショートカットとコマンド一覧を表示 | | `/model` | LLM provider とモデルを切り替え | | `/memory` | 永続メモリの表示 / 管理 | | `/history` | 過去セッションの閲覧と再開 | | `/goal` | 金融リサーチ goal の開始 / 確認 | | `/search` | 全セッション横断の全文検索 | | `/swarm` | マルチエージェント preset（委員会 / クオンツ / リスク） | | `/skill` | skills の一覧 / 読み込み / 解除 | | `/show` | 過去の run を id で表示 | | `/clear` | 現在の会話をクリア | | `/pine` | 現在の戦略を Pine Script として書き出し | | `/journal` | 取引履歴 CSV を分析 | | `/shadow` | シャドーアカウントの学習 / 表示 | | `/export` | 現在のセッションを書き出し（md / json） | | `/debug` | デバッグパネル切り替え（token 使用量 / レイテンシ） | | `/comps` | 類似企業分析（ピア倍率 → 含意レンジ） | | `/dcf` | DCF 評価と感応度グリッド | | `/attrib` | Brinson-Fachler 要因分解（アロケーション vs 銘柄選択） | | `/memo` | 投資メモ — 論点、コンセンサスと異なる見立て、シナリオ、撤退条件 | | `/earnings` | 決算レビュー — 売上から EPS までのサプライズ分解 | | `/screen` | 体系的アイデアスクリーン — 仮説、ファネル、残存キュー | | `/playbook` | 定期リサーチのテンプレート（一覧 / 実行 / スケジュール） | | `/connector` | 取引 connector profile（状態 / 開始 / 停止） | | `/halt` | キルスイッチ — すべてのライブ取引を即時停止 | | `/resume` | キルスイッチを解除（ライブ取引を再開） | | `/data` | データルーティングモード | | `/quit` | 終了（q、exit、:q も可） |

Single run & flags

```bash 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 ``` ```bash 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 vibe-trading --code vibe-trading --pine # Export indicators (TradingView + TDX + MT5) vibe-trading --trace vibe-trading --continue "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 を返します。 ```bash 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 ``` `vibe-trading channels login feishu` は、ログイン成功を報告する前に、QR 認可で取得したアプリ資格情報を `~/.vibe-trading/agent.json` に保存します（ファイル権限は所有者のみ）。 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` はリセットではなく通常メッセージとして処理されます）。 **Web UI から設定**: Settings ページの **IM Channels** パネルでは、ファイルを手編集せずにチャンネルを設定できます。チャンネルを展開すると設定パネルが開きます。フィールドはバックエンドのメタデータから描画され、secret の値はブラウザに返されず、マスク表示（`****` ＋末尾 4 文字）のみです。DingTalk が最初の完全なガイド付きチャンネルです：[open-dev.dingtalk.com](https://open-dev.dingtalk.com/) でアプリを作成し、ボット機能を追加して Stream Mode を有効化（公開コールバック URL 不要）、AppKey を Client ID、AppSecret を Client Secret にコピーしてアプリを公開します。QQ も完全ガイド付きチャンネルになりました：QQ公式プラットフォーム（[q.qq.com](https://q.qq.com/)）でボットを登録し、AppID と AppSecret をフォームにコピーし、保存前に **Test connection** で検証してから有効化します（公開コールバック URL 不要、公式 botpy SDK による WebSocket 接続）。**Test connection** は保存前にフォームの入力値だけで接続を試み、正直な結果コード（`ok` / `invalid_credentials` / `network` / `unsupported`）を返します。**Enable** は即適用：稼働中の channel runtime はプロセス再起動なしに該当アダプターのみをホットスワップし、有効化時に認証情報を自動検証します（検証失敗後に明示的に **Enable anyway** を選んだ場合のみスキップ）。無効化しても保存済み認証情報は残るため、再有効化時に再入力は不要です。ここには組み込みアダプターのみが表示されます。entry points 経由のプラグインチャンネルは引き続きファイルで設定します。 保存は `~/.vibe-trading/agent.json` の `channels.` をアトミックに更新します。YAML 設定ファイルは Web UI から読み取り専用です（ブラウザ編集には JSON が必要で、パネルはエラーの代わりにその旨を表示します）。専用ガイドのないチャンネルはデフォルト設定から生成された汎用フォームを描画します。

--- ## 💡 例 ### Strategy & Backtesting ```bash # 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 ``` **事前構築 alpha zoo を 1 行でベンチ**: ```bash vibe-trading alpha bench --zoo gtja191 --universe csi300 --period 2018-2025 --top 20 ``` **カタログを閲覧**して個別の alpha を確認: ```bash vibe-trading alpha list --zoo gtja191 --theme reversal --limit 10 vibe-trading alpha show gtja191_171 ``` **zoo からマルチファクターシグナルを構成**（Python）: ```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 ```bash # 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 ```bash # 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 ```bash # 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 ```bash # 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 サーバー ```bash 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` | ドキュメント・データファイル・画像をアップロード | | `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` | スケジュール済みジョブを一覧 | | `GET` | `/scheduled-runs/status` | 実行器の状態と設定済み配信ターゲット | | `GET` | `/scheduled-runs/{job_id}` | スケジュール済みジョブを 1 件取得 | | `DELETE` | `/scheduled-runs/{job_id}` | スケジュール済みジョブをキャンセル | | `POST` | `/scheduled-runs/proposals/{proposal_id}/commit` | エージェント提案の作成/キャンセルを確定 | | `POST` | `/scheduled-runs/proposals/{proposal_id}/discard` | エージェント提案を破棄 | | `GET` | `/scheduled-runs/playbooks` | リサーチテンプレートを一覧 | | `GET` | `/scheduled-runs/playbooks/{slug}` | テンプレート 1 件と宣言済み変数を表示 | | `POST` | `/scheduled-runs/playbooks/{slug}` | テンプレートからジョブをスケジュール | | `POST` | `/sessions/{id}/cancel` | 進行中の実行を停止（失敗ではなくキャンセルとして記録） | | `POST` | `/sessions/{id}/title/auto` | 最初のやり取りからセッション名を生成（手動リネームは上書きしない） | | `GET` | `/correlation/regime` | 相関エッジ密度のレジームタイムライン | | `GET` | `/agents.json` · `POST` `/v1/query` | OpenBB Workspace ブリッジ — 任意の `openbb` extra 導入時のみ登録、`/v1/query` は認証必須 | 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 ` を使ってください。Browser EventSource streams は、Settings で同じ key を一度入力した後、Web UI が処理します。 Shell-capable process tools（`bash` / `background_run` / `cancel_background`）はインタラクティブな local CLI でのみ有効です。それ以外のすべての面 — HTTP/SSE API と MCP server の**すべての** transport（stdio を含む）— は、`VIBE_TRADING_ENABLE_SHELL_TOOLS=1` を明示的に設定する（または `vibe-trading-mcp` に `--enable-shell-tools` を渡す）まで無効のままです。transport の種類が暗黙に shell アクセスを許可することはありません。Document と journal readers は既定で upload/import roots に制限されます。ファイルは `~/.vibe-trading/uploads`、`~/.vibe-trading/runs`、`./uploads`、`./data`（または旧来の `agent/uploads` / `agent/runs`）の下に置くか、`VIBE_TRADING_ALLOWED_FILE_ROOTS` で専用 directory を追加してください。セッション、実行成果物、swarm 実行、アップロード、`sessions.db` インデックスは `~/.vibe-trading` 配下に統一されています（shell 環境変数 `VIBE_TRADING_HOME` で丸ごと移動可能）。旧位置の履歴は初回起動時に自動で移行されます。 ### 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 を繰り返しスケジュールで実行します。Web UI の**スケジュール**ページからも REST からも操作できます。バックグラウンド executor は**既定でオフ**です。`VIBE_TRADING_ENABLE_SCHEDULER=1` を付けて server を起動すると有効になります: ```bash VIBE_TRADING_ENABLE_SCHEDULER=1 vibe-trading serve --port 8899 ``` その後、REST でジョブを作成します。`schedule` は単なる整数（interval は**ミリ秒**）か、5 フィールドの cron 式（`分 時 日 月 曜日`。各フィールドは `*`、`*/n`、数値、カンマ区切りリスト、`1-5` のような範囲に対応）です。cron はジョブの任意の `timezone`（IANA キー）の壁時計で評価され、夏時間の切り替え後もリズムは変わりません——存在しない時刻（春の進み）はスキップされ、重複する時刻（秋の戻り）は最初の 1 回だけ実行されます。`timezone` のないジョブは従来どおり UTC で動作します: ```bash # 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 * * *"}' # 平日 23:30（オークランドの壁時計、夏時間でもずれない） curl -X POST http://localhost:8899/scheduled-runs \ -H "Content-Type: application/json" \ -d '{"prompt":"Pre-open scan of NZX names","schedule":"30 23 * * 1-5","timezone":"Pacific/Auckland"}' # 一覧 / キャンセル curl http://localhost:8899/scheduled-runs curl -X DELETE http://localhost:8899/scheduled-runs/ ``` 各実行は新しい agent session で `prompt` を実行し（任意の backtest パラメータは `config` に入れます）、ジョブは `~/.vibe-trading/` に永続化されるため再起動後も残ります。このフラグがない場合、`/scheduled-runs` endpoints はジョブを記録しますが実行はされません。`API_AUTH_KEY` を設定している場合は各呼び出しに `-H "Authorization: Bearer "` を付けてください。 エージェントに見えるスケジューリングツールは `scheduled_research` の 1 つだけです。読み取り系アクションは状態/ジョブ/テンプレートを照会し、`propose_create` と `propose_cancel` は短時間で失効する確認プロポーザルを保存するだけで、ジョブストアを直接変更することはありません。Web は決定的な確認カードを表示し、CLI は `y/N` を尋ね、IM 会話では正確に `confirm`（`确认`）または `cancel`（`取消`）と返信する必要があります——commit エンドポイントを呼ぶのはこれらの操作だけです。`end_at` を過ぎたジョブは `expired` になり、再実行されません。配信はチャネル非依存です。`channels.deliveryTargets` に再利用可能な不透明ターゲット参照を設定すると、エージェントと確認 UI には ref/label/channel のみが見え、プロバイダの生の chat/user id は渡りません。アダプタが受領証なしで成功した場合の配信状態は `accepted`、プロバイダのメッセージ id が返ったときだけ `sent` になります（現在は Feishu がエンドツーエンド対応）。 スケジューラには**すぐ使えるリサーチテンプレートが 5 本**同梱されています —— `premarket-brief`、`earnings-season-tracker`、`portfolio-checkup`、`a-share-money-flow`、`institutional-holdings-diff`。各テンプレートはツール名を挙げず、必要なデータを自然言語で宣言するため、ツール面が広がってもそのまま機能します。また、欠けている入力は記憶で埋めず**明示する**ことが求められます。CLI、REST、TUI の `/playbook` から利用できます： ```bash vibe-trading playbook list # 5 本のテンプレート vibe-trading playbook show premarket-brief # 本文・宣言済み変数・推奨頻度 vibe-trading playbook create premarket-brief \ --var home_market="US equities" --var watchlist="AAPL, MSFT, NVDA" \ --timezone America/New_York curl http://localhost:8899/scheduled-runs/playbooks curl http://localhost:8899/scheduled-runs/playbooks/premarket-brief curl -X POST http://localhost:8899/scheduled-runs/playbooks/premarket-brief \ -H "Content-Type: application/json" \ -d '{"variables":{"home_market":"US equities","watchlist":"AAPL, MSFT, NVDA"}}' ``` `{}` を POST すると、テンプレート自身の推奨頻度と既定変数でスケジュールされます。描画された本文はそのままジョブの prompt になり、宣言されていない変数は黙って無視されず拒否されます。 --- ## 🔌 MCP Plugin Vibe-Trading は MCP-compatible client 向けに 74 MCP tools を公開します。stdio subprocess として動作し、server setup は不要です。Core research tools は HK/US/crypto で API key なしに動作し、trading connector tools は選択中の connector profile を使います。LLM key が必要なのは `run_swarm` のみです。 **環境変数:** server は client 自身が spawn するため、shell の `export` は届きません —— client の `env` block に設定してください。生成された backtest code は allowed run roots 内に制限されるので、結果を自分の作業 directory に書き出すには `VIBE_TRADING_ALLOWED_RUN_ROOTS` が必要です: ```json { "mcpServers": { "vibe-trading": { "command": "vibe-trading-mcp", "env": { "VIBE_TRADING_ALLOWED_RUN_ROOTS": "C:\\Users\\me\\research" } } } } ```

Claude Desktop

`claude_desktop_config.json` に追加: ```json { "mcpServers": { "vibe-trading": { "command": "vibe-trading-mcp" } } } ```

OpenClaw

`~/.openclaw/config.yaml` に追加: ```yaml skills: - name: vibe-trading command: vibe-trading-mcp ```

Cursor / Windsurf / other MCP clients

```bash vibe-trading-mcp # stdio (default) vibe-trading-mcp --transport http # Streamable HTTP (spec default) at /mcp vibe-trading-mcp --transport sse # legacy SSE (deprecated) ```

**公開される MCP tools（74）:** `list_skills`, `load_skill`, `start_research_goal`, `get_research_goal`, `add_goal_evidence`, `update_research_goal_status`, `backtest`, `factor_analysis`, `alpha_zoo`, `alpha_bench`, `analyze_options`, `analyze_options_payoff`, `pattern_recognition`, `read_url`, `read_document`, `web_search`, `write_file`, `read_file`, `list_strategies`, `query_strategies`, `get_strategy_evidence`, `refresh_strategy_evidence`, `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`, `qveris_search`, `qveris_inspect`, `qveris_execute`, `get_institutional_holdings`, `etf_holdings`, `prediction_market`, `research_papers`, `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`, `quantlib_call`, `cashflow_performance`, `orderbook_depth`, `sentiment`, `technical_indicators`, `get_fundamentals`. ### SWARM の外部 MCP tools `run_swarm` の worker は、運用者が承認した外部 MCP server のツールを呼び出せます。サーバー側の allowlist を `VIBE_TRADING_SWARM_AGENT_CONFIG`、`~/.vibe-trading/swarm-agent.json`、またはフォールバックの `~/.vibe-trading/agent.json` に設定し、swarm preset ではローカル MCP のラッパー名（例：`mcp_internal_kb_search`）でリモートツールを列挙します。呼び出し側が渡す `variables` はテンプレートのデータに留まり、MCP URL・コマンド・環境変数・allowlist の上書きを注入することはできません。

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

```bash 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](https://clawhub.ai/skills/vibe-trading)

OpenSpace — self-evolving skills

90 の finance skills はすべて [open-space.cloud](https://open-space.cloud) に公開され、OpenSpace の self-evolution engine を通じて自律的に進化します。 OpenSpace と使うには、agent config に両方の MCP servers を追加してください。 ```json { "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 は 90 skills を自動検出し、auto-fix、auto-improve、community sharing を可能にします。OpenSpace-connected agent では `search_skills("finance backtest")` から Vibe-Trading skills を検索できます。

### MetaTrader 5（Exness などの MT5 ブローカー） 公式の `MetaTrader5` パッケージ経由で、**ローカルで稼働中の MT5 terminal** に接続します（**Windows 専用**）: ```bash pip install "vibe-trading-ai[mt5]" ``` `~/.vibe-trading/mt5.json` を設定します（手動で作成し、対応環境では chmod 600 を設定）: ```json { "login": 12345678, "password": "...", "server": "Exness-MT5Trial8", "symbol_suffix": "m", "max_order_volume": 1.0, "max_order_notional_usd": 10000 } ``` 続いて: ```bash vibe-trading connector use mt5-paper-sdk vibe-trading connector check vibe-trading connector account vibe-trading connector quote EURUSD vibe-trading connector history EURUSD ``` | Profile | 口座 | 注文 | |---------|------|------| | `mt5-paper-sdk` | デモ | 読み取り専用 | | `mt5-live-sdk-readonly` | リアル | 読み取り専用 | | `mt5-paper-trade` | デモ | 直接発注（connector のサイズガードが適用されます） | | `mt5-live-trade` | リアル | mandate + kill-switch によるゲート | 安全境界: **「paper」はブローカーのデモ口座**を指し、毎回の呼び出しで検証されます — terminal が `account_info().trade_mode` と login を返すため、リアルマネー口座に接続された paper profile（またはその逆）は強制的に拒否されます。MT5 の注文サイズは**ロット**単位です（1 lot EURUSD = 100,000 EUR）。live の mandate ゲートは connector の USD サイジングフックを通じてロットを USD 換算し、connector 自身の `max_order_volume` / `max_order_notional_usd` ガードはデモと live の**両方**に適用され、名目額を価格換算できない場合は fail-closed になります。ヘッジ口座（Exness の既定）での注意: 反対サイドの注文は**ヘッジを新規に建てます** — ポジションは ticket 指定でクローズしてください（position ticket を指定した `trading_cancel_order`）。これにより deal がそのポジションに固定され、エクスポージャーの削減のみが行われます。ロールバック / 停止経路: kill switch は新規の live 注文をブロックし、キャンセルは引き続き利用可能で監査ログに記録されます。Mandate の上限は USD 建てです。USD 以外の口座通貨の場合は、ブローカー側で口座通貨建ての証拠金として強制されます。 `mt5` マーケットデータ loader（為替フォールバックチェーンの先頭）は同じ `mt5.json` を共有します — ファイルがない場合は、最後に使用されたログイン済み terminal に読み取り専用で接続します。 --- ## 🔌 eToro Public API コネクタ API キーペア（`x-api-key` + `x-user-key`）で [eToro Public API](https://builders.etoro.com/) のデモ口座・リアル口座に接続します。デモとリアルは**構造的に**分離されており、デモキーは `/demo` API パスにしか到達しません。 `~/.vibe-trading/etoro.json` を設定します（自分で作成してください。対応環境では `chmod 600`）： ```json { "api_key": "YOUR_PUBLIC_API_KEY", "user_key": "YOUR_USER_KEY", "profile": "paper" } ``` 代わりに `~/.vibe-trading/.env` で `ETORO_API_KEY` と `ETORO_USER_KEY` を設定することもできます。 その後： ```bash vibe-trading connector use etoro-paper-sdk vibe-trading connector check vibe-trading connector account vibe-trading connector positions vibe-trading connector quote BTC ``` | プロファイル | 口座 | 発注 | |-------------|------|------| | `etoro-paper-sdk` | デモ | 読み取り専用 | | `etoro-live-sdk-readonly` | リアル | 読み取り専用 | | `etoro-paper-trade` | デモ | デモパスへの直接発注 | | `etoro-live-trade` | リアル | mandate + kill switch によるゲート | 銘柄検索は eToro の `internalSymbolFull` 検索を使います（例：`BTC` → instrument id `100000`）。取引前に `etoro_search_instruments` エージェントツールでティッカーを解決してください。 安全境界：デモとリアルはパス分離かつキー束縛です（`paper_guard: path_separated_key_bound`）。リアルでリスクを増やす操作（新規建て、コピー開始/増額）には、認可された mandate、停止していない明確な状態、そしてコピー名目額を制限するための検証済み USD 口座が必要です。検証済みの全決済・部分決済、未約定注文のキャンセル、コピー終了は停止中でも利用でき、すべて監査ログに記録されます。保留中の決済のキャンセルとポジションのストップ編集は**デモ専用**です。これらはエクスポージャーを増やしたり追加証拠金を移動させたりし得る一方、増分の USD リスクを定量化できるだけの API データがないため、リアル経路は fail-closed になります。コピー金額は eToro 口座通貨建てで、コピーの開始・調整のたびに呼び出し側が 1〜35 文字の URL-safe な参照 id を指定する必要があります。eToro 固有の書き込み系ツール（`etoro_close_position`、`etoro_copy_*` など）は**エージェントツール専用**で、MCP や CLI には公開されません。ロールバック：該当コネクタのコミットを revert するかプロファイルを無効化します。halt は新規のリアル・リスク増加操作をブロックします。 --- ## 🔌 外部 MCP Server からツールを読み込む（MCP Client モード） > **これは上の MCP Plugin とは逆方向です。** > MCP Plugin は*他の* agent に Vibe-Trading のツールを呼ばせるものです。 > 本節は*組み込みの* Vibe-Trading agent が*あなたの*外部 MCP server のツールを呼ぶためのものです。 ### クイックスタート `~/.vibe-trading/agent.json` を作成します： ```json { "mcpServers": { "my-server": { "command": "uvx", "args": ["my-mcp-server"] } } } ``` あとは任意の CLI コマンドを実行するだけです。通常の外部 server のツールは、ローカルツールの後に agent のレジストリへ自動的に注入されます： ```bash vibe-trading run "use my-server to do X" ``` ### IBKR 公式 MCP の読み取り専用プローブ Vibe-Trading は Interactive Brokers の公式リモート MCP endpoint に読み取り専用で直接接続できます。 `~/.vibe-trading/agent.json` に次を追加します： ```json { "mcpServers": { "ibkr": { "type": "streamableHttp", "url": "https://api.ibkr.com/v1/api/mcp-public", "auth": { "type": "oauth", "scopes": ["mcp.read"], "clientName": "Vibe-Trading", "cacheDir": "~/.vibe-trading/live/ibkr/oauth" }, "enabledTools": ["*"] } } } ``` 続いてブラウザでの OAuth フローを開始します： ```bash vibe-trading connector authorize ibkr-live-official-mcp-readonly ``` ワイルドカードが認められるのは IBKR の `mcp.read` プローブに限られます。この profile を認可しても 確認できるのは IBKR 公式の読み取り scope へのアクセスまでで、IBKR が安全にマッピングできる安定した 読み取りツール名を公開するまで、汎用の `trading_account` と `trading_positions` の呼び出しは無効の ままです。`mcp.write` を加える設定では、ツールの allowlist を明示的に固定する必要があり、それでも ライブ発注ガードを通過します。 IBKR から事前登録済みの OAuth client が発行されている場合は、`auth` の中に `clientId` と `clientSecret` を追加してください。 ### 取引 connectors：最短ルート IBKR の OAuth client 承認を待てない場合は、ローカルの TWS または IB Gateway セッションに接続します。 認証情報は IBKR のデスクトップアプリ内に留まり、Vibe-Trading は `127.0.0.1` に接続して connector profile として公開するだけです。 オプションの SDK をインストールします： ```bash pip install "vibe-trading-ai[ibkr]" ``` TWS のペーパートレードまたは IB Gateway のペーパーを開き、API socket clients を有効にしてから実行します： ```bash vibe-trading connector list vibe-trading connector use ibkr-paper-local vibe-trading connector configure ibkr-paper-local --yes vibe-trading connector check vibe-trading connector account vibe-trading connector positions vibe-trading connector orders vibe-trading connector quote AAPL vibe-trading connector history AAPL --duration "30 D" --bar-size "1 day" ``` ローカルの既定ポート： | アプリ | ペーパー | ライブ読み取り専用 | |--------|----------|--------------------| | TWS | `7497` | `7496` | | IB Gateway | `4002` | `4001` | agent が公開する connector スコープのツールは `trading_connections`、 `trading_select_connection`、`trading_check`、`trading_account`、`trading_positions`、 `trading_orders`、`trading_quote`、`trading_history` です。ライブブローカーの生の MCP ツールが `mcp__*` として直接登録されることはありません。IBKR の発注ツールは一つも登録されません。 ### 🔐 TAP モード — 認証情報の完全分離と人間による書き込み承認 **オプトイン、既定はオフ。** 下記の `TAP_*` 変数が未設定なら、connector の挙動はこれまでと完全に 同じ（ブローカー SDK 直結）で、何も変わりません。 [TAP](https://tap.human.tech)（Tool Authorization Protocol）は認証情報のプロキシです。agent が ブローカー API の生のシークレットを持つことはなく、影響のある書き込みは**人間の承認**で gate されます。 TAP モードを有効にすると、**すべての** Alpaca 呼び出し（発注・キャンセル・および account / positions / orders / quote / bars の読み取り）が、ブローカー SDK ではなく TAP プロキシの `/forward` endpoint へ送られます。TAP がサーバー側で本物のキーを注入してから上流へ転送します。 - agent プロセスは **Alpaca のキーを一切保持しません**。`alpaca-py` すら不要です。egress 全体が TAP を通るためで、シークレットは名前（``）で参照され、TAP が置換します。 - **書き込みは人間の承認でブロックされます。** 発注もキャンセルも、人が承認しない限りブローカーには 届きません。prompt インジェクションによる「今すぐ買え」も保留され、拒否すれば Alpaca に届くことは ありません。注文には決定的な `client_order_id` が付くため、承認レースでの再試行は重複発注ではなく 重複排除されます。 - **読み取りは自動承認。** account / positions / orders / quote / bars は GET であり、TAP は人間の ステップなしに転送します。これは認証情報の*分離*（プロセス内にキーがない）であって gate ではないので、 追加の摩擦はほぼゼロです。 - TAP 認証情報の `allowed_hosts` がキーの送信先を固定するため、改ざんされた宛先は注入前に拒否されます（403）。 **有効化の手順：** 1. TAP ダッシュボードで `alpaca` という名前の**マルチシークレット**認証情報を作成し、Alpaca のキーペアを `key_id` と `secret_key` のフィールドに格納して agent に割り当て、allowed hosts に `paper-api.alpaca.markets`（またはライブの `api.alpaca.markets`）**および** `data.alpaca.markets` （quote / bars が使う市場データホスト）を指定します。**ペーパーとライブには別々の TAP 認証情報**を 使ってください（例：`alpaca-paper` / `alpaca-live`、`TAP_ALPACA_CREDENTIAL` で選択）。それぞれの `allowed_hosts` を自分の API ホストに固定すれば、TAP は構造的にペーパーのキーをライブホストへ送ることを 拒否し、逆も同様で、ペーパー／ライブの分離が端から端まで明確に保たれます。 2. `agent/.env` に追加します： | 変数 | 必須 | 説明 | |------|:----:|------| | `TAP_PROXY_URL` | はい | TAP プロキシのベース URL（例：`https://proxy.tap.human.tech`） | | `TAP_AGENT_KEY` | はい | あなたの TAP agent API キー（シークレット） | | `TAP_ALPACA_CREDENTIAL` | いいえ | Alpaca 用の TAP 認証情報名（既定は `alpaca`） | | `TAP_APPROVAL_TIMEOUT` | いいえ | 人間の判断を待つ秒数（既定は `300`） | 書き込みが発生したら、TAP のチャンネル（Telegram / ダッシュボード）で承認または拒否します。承認された 発注・キャンセルは Alpaca へ転送され、拒否またはタイムアウトしたものはエラーを返し、**決して送信されません**。 > **既知の制限 — 承認レース。** ちょうど `TAP_APPROVAL_TIMEOUT` の境界で人が承認した場合、ポーリング側が > 既に諦めている一方で TAP が注文を転送してしまうことがあります。この場合、注文はブローカーに届いている > のに gate はエラーを報告し、`max_trades_per_day` のカウンタが 1 件少なく数えます。決定的な > `client_order_id` により再試行がその注文を二重に出すことは防げますが、1 日の取引回数上限を厳密に運用 > している場合は、TAP のタイムアウトエラーの後に再試行する前に未約定注文を確認してください。 **スコープ：** Alpaca の**発注・キャンセルと 5 つの読み取りすべて** — つまり connector の egress 全体を カバーするため、どの経路でもプロセスはキーを保持しません。HMAC 署名型のブローカー（Binance / OKX）は 今後の課題です（クライアント側署名は純粋な egress 注入に馴染みません）。これらのフックは追加的で、 Alpaca connector の内部に閉じており、ライブ mandate ゲートは変更しません。 ### 設定リファレンス | フィールド | 型 | 既定値 | 説明 | |------------|----|--------|------| | `type` | string | stdio では推論、HTTP では必須 | stdio では省略、URL ベースの server では `sse` / `streamableHttp` を指定。 | | `command` | string | stdio では必須 | stdio server で起動する実行ファイル。`sse` / `streamableHttp` では無効。 | | `args` | array | `[]` | stdio server 専用のコマンドライン引数。 | | `env` | object | `{}` | stdio server 専用。サブプロセスの環境にマージされる追加の環境変数。 | | `url` | string | `sse` / `streamableHttp` では必須 | リモート SSE / streamable HTTP endpoint の URL。stdio では未使用。 | | `headers` | object | `{}` | `sse` / `streamableHttp` server 専用の追加 HTTP ヘッダー。 | | `toolTimeout` | number | `30` | ツール呼び出し 1 回あたりのタイムアウト（秒） | | `initTimeout` | number | 未設定（`max(toolTimeout, 30)`） | MCP initialize / OAuth 認可のタイムアウト（秒）。通常のツール呼び出しを広げずに、遅いブラウザ認可に対応するために使います。 | | `enabledTools` | array | `["*"]` | ツールの allowlist。`["*"]` でその server の全ツールを公開 | 設定ファイルの場所：`~/.vibe-trading/agent.json`（JSON または YAML）。 URL ベースの transport では `type` が必須です。agent は URL の接尾辞から SSE と streamable HTTP を 推測しなくなりました。 ### セッション単位の上書き（API） API で session を作成する際、`session.config` の中に `mcpServers` を渡すと、そのセッションに限って グローバル設定を拡張・上書きできます： ```json { "config": { "mcpServers": { "research-server": { "command": "uvx", "args": ["research-mcp"], "enabledTools": ["search", "fetch"] } } } } ``` ### ツールの命名 通常のリモートツールは安定した名前 `mcp__` で公開されます。 ライブブローカーの MCP server は `trading_*` connector の表面の背後に留まります。 2 つの server 名がローカル名の正規化後に同じ ASCII セーフな接頭辞になる場合（例：`foo-bar` と `foo_bar` がどちらも `foo_bar` になる）、名前の一意性を保つために server セグメントへ決定的なハッシュ 接尾辞が付加され、運用者に警告が出ます： ``` WARNING: Configured MCP server 'foo-bar' collides with another server after local name normalization. Using local tool prefix 'mcp_foo_bar__' to keep generated tool names unique. Rename the server in agent config if you want a different prefix. ``` ### v1 の制限 | 制限 | 詳細 | |------|------| | Transport | stdio、SSE、streamable HTTP | | 実行 | 直列のみ — MCP ツールが並列 readonly 経路に入ることはありません | | 対象面 | tools のみ（v1 では resources と prompts は対象外） | | ホットリロード | 非対応 — 設定変更の反映にはプロセス再起動が必要 | | Swarm 経路 | v1 では Swarm worker のレジストリに MCP ツールは入りません | --- ## 📁 プロジェクト構成

クリックして展開

``` Vibe-Trading/ ├── agent/ # バックエンド (Python) │ ├── cli/ # CLI パッケージ — インタラクティブ TUI + サブコマンド │ ├── api_server.py # FastAPI サーバー — runs、sessions、upload、swarm、SSE │ ├── mcp_server.py # MCP サーバー — OpenClaw / Claude Desktop 向け 74 tools │ │ │ ├── src/ │ │ ├── agent/ # ReAct エージェントコア │ │ │ ├── loop.py # 5 層コンテキスト圧縮 + read/write ツールバッチング │ │ │ ├── context.py # システムプロンプト + 永続メモリからの自動 recall │ │ │ ├── skills.py # skill ローダー（90 個同梱 + CRUD でユーザー作成） │ │ │ ├── tools.py # ツール基底クラス + レジストリ │ │ │ ├── memory.py # run ごとの軽量ワークスペース状態 │ │ │ ├── frontmatter.py # 共有 YAML frontmatter パーサー │ │ │ └── trace.py # 実行トレースライター │ │ │ │ │ ├── memory/ # クロスセッション永続メモリ │ │ │ └── persistent.py # ファイルベースメモリ (~/.vibe-trading/memory/) │ │ │ │ │ ├── tools/ # 107 個の自動検出エージェントツール │ │ │ ├── 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 — 5 つのファミリーにまたがる 462 個の 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 (12) + fundamental (4) │ │ │ │ │ ├── api/ # FastAPI ルートモジュール │ │ │ └── alpha_routes.py # /alpha/list、/alpha/{id}、/alpha/bench、SSE ストリーム │ │ │ │ │ ├── skills/ # 9 カテゴリ 90 個の finance skills（各 SKILL.md） │ │ ├── swarm/ # Swarm DAG 実行エンジン │ │ │ └── presets/ # 30 個の swarm preset YAML 定義 │ │ ├── session/ # マルチターンチャット + FTS5 セッション検索 │ │ └── providers/ # LLM プロバイダー抽象化 │ │ │ └── backtest/ # バックテストエンジン │ ├── engines/ # 9 エンジン + クロスマーケット composite engine + options_portfolio │ ├── loaders/ # 28 ソース: tushare、okx、nobitex、wallex、binance、yfinance、akshare、baostock、tencent、mootdx、ccxt、futu、pykrx、local、eastmoney、sina、stooq、yahoo、finnhub、alphavantage、tiingo、fmp、longbridge、mt5、qveris、india_broker、tickerall、gildata │ │ ├── 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](https://github.com/HKUDS)** agent ecosystem の一部です。

NanoBot Ultra-Lightweight Personal AI Assistant

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](https://github.com/HKUDS/Vibe-Trading/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 | Turnover を考慮したオプティマイザは **0.1.11 でリリース済み**；残りは Planned | | **Alpha Zoo** | 462 個の事前構築 alpha 因子（Qlib 158 + Kakushadze 101 + GTJA 191 + academic + fundamental）、1 行 CLI でベンチ、agent 統合、Web UI | **0.1.8 でリリース済み**、0.1.12 まで拡張 | | **Strategy Development Manager** | Register papers / broker research as factors & strategies with a persistent store + automated IC/Sharpe decay lifecycle | **0.1.11 でリリース済み** | | **Correlation Regime** | Edge-density + hysteresis regime timeline layered on `/correlation` — spot when markets fuse into one bloc | **0.1.12 でリリース済み** | | **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](CONTRIBUTING.md) を参照してください。 **Good first issues** は [`good first issue`](https://github.com/HKUDS/Vibe-Trading/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) でタグ付けされています。気になるものから始めてください。 より大きな貢献を検討している場合は、上の [Roadmap](#-ロードマップ) を確認し、着手前に issue を開いて相談してください。 --- ## Contributors Vibe-Trading に貢献してくださった皆さまに感謝します。 最近の v0.1.14 サイクルの貢献者とクレジット： - @Shizoqua — a 13-PR correctness sweep across nearly every subsystem: grounding auto-recovers identity and price evidence within a bounded budget (#1092), swarm isolates worker artifacts between retries (#1053), rejects raw `ok`/`success` tool-result envelopes (#1052) and truncates oversized results with the shared notice (#1110), MCP gains offset paging for SEC filings and statements (#1138), routes `load_skill` through the registry so oversized skills page (#1137) and carries market-data provenance on `get_market_data` (#1131), plus `excess_return` consistency (#1058), Wilder-EWM RSI (#1056), the FTS5 tokenizer floor (#1071), non-finite prediction-market fields (#1136), in-flight delivery protection (#1140) and preserved backtest validation evidence (#1139) - @shadowinlife — the run-analysis surface, four pages in one cycle: Options Lab (#1096), the Factor Research panel with its new IC correlation matrix (#1099), positions structure visualization (#1097) and the tearsheet tab (#1091); plus evidence-gated Strategy Discovery Phase 1 (#978) and Phase 2 decay monitoring (#1007), per-market volume units in market-data provenance (#1065) and baostock volume normalized to board lots (#1067) - @pengpengyi92 — five quantlib numerics fixes: `xirr` and money-weighted return survive long-horizon discount underflow (#1119), zero-volatility options discount their forward value (#1066), the fixed-income curve keeps decay inside the requested bounds (#1076), event studies anchor to the prior session (#1078) and cross-validation aligns label ends to the prior observation (#1079) - @cgycorey — reasoning effort honoured in chat completions (#1025), the per-task swarm `ChatLLM` closed to stop a pooled-connection leak (#1145) and the same for one-shot clients (#1153), `gross_profit` derived from revenue minus COGS when the SEC tag is absent (#1111), and `vibe-trading show ` dispatching its run id instead of the flag (#1147) - @lorenzozanee — the test suite stopped escaping into the real config root and its live audit ledger (#1118, closes #1116), recovery steering delivered as user messages with inline system tags (#1112), and unsupported ticker-plus-name symbol queries marked skipped rather than failed (#1114) - @AndyLongest — the interactive backtest research dashboard (#1084), the engine reporting actual post-fill positions (#1082), and grounding ignoring identity constants in rate formulas (#1083) - @ofeksh-tr — eToro runtime UI parity for SDK connector status (#1051) and its crypto browse and flat market-data quotes (#1070), plus an empty `Response` for the `scheduled-runs` DELETE 204 (#1068) - @wiliao — the agent-run reliability pass: grounding false-rejections, the final-answer gate and LLM timeouts (#1105), with prompt wording and support/resistance masking (#1060) - @jay79-boop — a selectable IBKR market-data tier with starved quotes reported as `no_data` (#1075), and strict alpha t-stats surfaced in the bench JSON and HTML report (#1085) - @Robin1987China — DCF refusing non-finite inputs instead of a silent negative share price (#1121), and grounding masking ISO dates that run into CJK text (#1132) - @zzz607 — grounding masking line-leading ordered-list markers before number extraction (#1063), and the East Money research-report endpoint given the time parameters it now requires (#1077) - @Echoandelementwebsites — worker prompts ordered for prompt-cache-friendly prefixes (#1057), and tool-less agents no longer instructed to call `write_file` (#1144) - @549236606-oss — seven extended read-only Futu connector endpoints, each fail-closed through the existing gateway envelope (#1135) - @QCYTSN — the desktop update safety boundary: PID-scoped shutdown, dormant candidate verification, interrupted-attempt recovery, and a tested tampered/unsigned/wrong-publisher/downgrade rejection matrix (#1101) - @honginp — offline USD-M account reconciliation with immutable snapshot contracts and deterministic drift reporting (#1106) - @he-yufeng — each monitor's latest verdict parsed server-side and persisted on the job for the Market Watch list (#1152) - @sykuang — GitHub Copilot as a provider through the official SDK, with no borrowed client ID and no editor-impersonation headers (#990) - @miguelangelo78 — the hosted TickerAll MetaTrader 5 data source, so forex and metals backtests need no local MT5 terminal (#968) - @ngoanpv — Vietnam equity (HOSE) support: `.VN` no longer executes under China A-share rules (#1033) - @jax-novita — Novita AI registered as a built-in OpenAI-compatible provider (#1059) - @daviddaco1 — the Spanish locale and `README_es.md`, the sixth README (#1087) - @1psconstructor — German (Deutsch) UI support (#1117) - @x-lambda — the tencent loader building its SSL context from the certifi CA bundle, unblocking HK quotes (#1113) - @er-s-an — `build_registry()` reporting partial construction instead of silently returning a short tool list (#1129) - @straun-repo — reasoning effort passed through to the Anthropic adapter (#1115) - @nstavros — `connector orders` rendering broker_sdk rows, with SDK enum reprs stripped and class-B tickers left intact (#1150) - @lukiod — `.env.partial` created with owner-only permissions (#1086) - @fixXxerTech — inferred strategy labels marked as inferred in the run dashboard (#1134) - @birdxs — Docker images carrying the Feishu and Telegram channel dependencies, with a GHCR/Docker Hub build workflow (#1088) - @zhiwuyazhe-fjr — a Docker Codex OAuth EOF that explains itself (#1054)

v0.1.12 サイクルの貢献者

- @santhreal — a 30-PR correctness sweep: strict-JSON / finite-number hardening across metrics, factors, pattern, and options (#764/#765/#766/#767/#739/#740/#744), loader correctness (#761 yahoo 1m bars), and session / journal robustness (#762/#763/#768/#769/#770) - @xkam7ar — broad reliability across packaging, web, scheduler, swarm, and CLI (#584), cancellation before the first AgentLoop iteration (#641, closes #638), QVeris session budget + atomic credit accounting (#685/#686), CI / OOS gates (#630/#632), and journal month-filter / side-parse fixes (#626/#628) - @shadowinlife — the Strategy Development Manager skill (#457, closes #455), pluggable OCR + LLM-vision extraction (#548), centralized provider credentials (#563), the 80× signal-alignment vectorization (#698), and swarm MCP-discovery caching (#704) - @ebujinovch — the correlation regime timeline endpoint + UI (#756, closes #719) and its `correlation-regime` skill (#557), plus the `academic_corr_rewire` factor (#705) - @honginp — Binance USD-M routing with execution/mark separation (#470/#716) and the maintenance-bracket decouple that keeps `-PERP` backtests zero-credential (#757) - @StaniellG — the MetaTrader 5 (Exness) broker connector + `mt5` data source (#481) - @tyj147454413-cmd — the Binance fallback loader (#643), bounded OKX history with rate-limit handling (#644), and codex stream-failure classification (#663) - @Marnie0415 — composite sub-engine fallback for unknown symbols (#734) and the frontend `insertBefore` streaming DOM-race fix (#717) - @YZY0108 — the look-ahead-bias fix across all five portfolio optimizers (#487) - @UNHNQ — the SiliconFlow CN + Global providers (#565) - @FenjuFu — the iFlytek Spark provider (#537) - @jelech — the native Anthropic Messages API adapter (#695) - @octo-patch — MiniMax regional API endpoints (#731) - @Thibaultjaigu — the Requesty OpenAI-compatible gateway provider (#474) - @Robin1987China — realized portfolio turnover metrics for every optimizer (#478) - @YogeshModi24 — the Frazzini-Pedersen betting-against-beta academic factor (#480) - @0xZKnw — opt-in TAP mode for Alpaca (#377) - @sambazhu — the fundamental zoo `_VALID_ZOOS` whitelist (#707) - @nareshkps — Robinhood connector `account_number` wiring (#726) - @darkknight4563 — user swarm-presets directory discovery (#570) - @MikeCer — IBKR thread-local connection pool + snapshot quotes (#636) - @Shizoqua — `local` loader interval resampling (#467) - @roberttidball — FastMCP transport import compatibility (#469) - @yxhuang — bare-ticker resolution in the correlation matrix (#472, closes #471) - @Bortlesboat — stale `OPENAI_BASE_URL` provider-switch fix (#484, closes #482) - @ananaymital — preflight `EnvConfig` stale-cache fix (#479, closes #477) - @GabbaTauchi — reported the native zai streaming / base-URL bug (#758) - @warren618 / Haozhe Wu — the correlation regime backend integration, the zai provider streaming + base-URL resolution fix (#758), release integration, and open-PR/issue triage

v0.1.11 サイクルの貢献者

- @shadowinlife — the `api_server` modularization capstone (1,103 → 371 lines, #424 closing #331), centralized env config with the AST CI gate (#440), loader `fetch()` protocol conformance (#437), and the Strategy Development Manager RFC in review (#455/#457) — 12 merged PRs this cycle - @Robin1987China — Research Autopilot Phase 3 loop closure (#267), 4 canonical academic alphas (#277), Shadow Account PIT-safe entry conditions (#302/#314/#316), the turnover-aware portfolio optimizer (#466), scheduled-research route tests (#452), and test-coverage batches for trade-journal / pattern / loader layers (#268/#269/#276) - @muku314115 — first-class Indian equity (NSE/BSE) support: the `IndiaEquityEngine`, cost stack, `.NS`/`.BO` routing, and the `india_broker` bridge (#305) - @mvanhorn — the end-to-end scheduled-research executor (#278), the Trading 212 read-only connector (#321), OpenAI default-model resolution (#319), and Robinhood config validation (#320) - @fei-moss — the `analyze_image` vision tool (#464), NapCat DM pairing (#463), and the IM-media allowed-roots report (#465) - @sambazhu — the value-investing toolkit: financial-rigor + report-audit tools, 4 skills, and the `value_investing_committee` preset (#407/#408) - @Elfsa-Miranda — the evidence-bound alpha research pipeline exploration (#405/#416, since re-scoped into #442) - @Hinotoi-agent — loopback CSRF rejection (#293) and authenticated remote same-origin UI requests (#304) - @dpersek — configurable IM reply timeout (#413) and the provider-preflight redirect fix (#404) - @digger-yu — cross-platform `setup`/`dev` commands (#292) and dev-dependency pre-checks (#349) - @skloxo — tilde expansion + file-roots safety fallback (#299) and reactive zh-CN localization (#301) - @kadaliao — the beginner tutorial (#393) and Alpha Library social cards (#396) - @morluto — CLI resume first-message preservation (#448) and the Codex OAuth default model (#446) - @yxhuang — the Kimi for Coding provider (#435) and the precise #433 diagnosis behind the governance-stack revert - @isaveall — the `validation.json` artifacts-dir fix (#429) and clearer `--swarm-run` errors (#428) - @mustafakamal88 — timezone-aware UTC timestamps (#397) - @irfanallana-oss — the zero-size order guard in `trading_place_order` (#417) - @Shizoqua — the central OHLC-invariant loader guard (#274) - @hobostay — SSRF-guard hardening for CGNAT/mesh ranges + the QQ media redirect fix (#389) - @aeonframework — Pillow / langchain CVE floor bumps (#390) - @hannibal-lee — the pandas version-constraint fix (#329) - @MarkfuGod — dynamic data-source counts + token-gated microcompaction (#296) - @gyx09212214-prog — strict JSON validation outputs (#306) - @LemonCANDY42 — the backtest report library (#224) - @fanfpy — Longbridge Decimal→float serialization (#459) - @asahikiko — packaged SKILL.md capability-count sync + the manifest guard test (#461) - @wison1717-maker — the mandate second-confirmation dialog + unified error toasts (#453) - @imsankz — opencode provider mappings (#444) - @flash1234pku — the tushare reference code-fence fix (#449) - @Penn-Live — the Docker startup route-iteration crash report (#450) - @warren618 / Haozhe Wu — the fundamental factor layer (PIT-safe SEC panels), the QVeris premium track, the IM channel runtime, India-equity integration review, CN search fallbacks, and release integration

v0.1.10 サイクルの貢献者

- @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 ` (#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](LICENSE) ---

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

---

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