Vibe-Trading: あなたのパーソナルトレーディングエージェント

たった1コマンドで、包括的なトレーディング機能を備えたエージェントを起動

機能 · デモ · 概要 · 始め方 · CLI · API · MCP · 構成 · ロードマップ · 貢献 · コントリビューター

--- ## 📰 ニュース - **2026-05-04** 🖥️ **インタラクティブCLI UX + CI整理**: インタラクティブモードに、provider/model、セッション時間、直近実行時間、累計ツール呼び出し統計を表示するライブ下部ステータスバーを追加。さらに `prompt_toolkit` により上下キーの履歴移動と左右キーのカーソル編集に対応しました（[#69](https://github.com/HKUDS/Vibe-Trading/pull/69)）。`prompt_toolkit` またはTTYが利用できない場合は、従来どおりRich promptにフォールバックします。CIのパス期待値も強化済みファイルimportサンドボックスとクロスプラットフォームな `/tmp` 解決に合わせ、mainはグリーンに戻りました（[`bb67dc7`](https://github.com/HKUDS/Vibe-Trading/commit/bb67dc7cfcc11553c57d8962bee56381dca43758)）。 - **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` スキルを追加し、バンドルスキル回帰テストで固定しました。公開ロードマップは 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](https://github.com/HKUDS/Vibe-Trading/pull/64)）。OpenAI Codex provider は `vibe-trading provider login openai-codex` による ChatGPT OAuth に対応し、Settings メタデータとアダプター回帰テストも追加（[#65](https://github.com/HKUDS/Vibe-Trading/pull/65)）。A株の ST/*ST リスクスクリーニング用 `ashare-pre-st-filter` スキルを追加・強化し、Sina 処分公告の関連性フィルターにより証券口座リスト内の言及が E2 回数を水増ししないようにしました（[#63](https://github.com/HKUDS/Vibe-Trading/pull/63)）。 - **2026-04-30** ⚙️ **Web UI設定 + validation CLI強化**: LLM provider/model、Base URL、reasoning effort、データソース認証情報をローカルで設定できる Settings ページを追加。settings API は local/auth で保護され、provider メタデータもデータ駆動設定に移行（[#57](https://github.com/HKUDS/Vibe-Trading/pull/57)）。さらに `python -m backtest.validation ` を強化し、引数なし・空パス・不正パス・存在しないパス・ディレクトリでないパスを検証開始前に分かりやすく失敗させます（[#60](https://github.com/HKUDS/Vibe-Trading/pull/60)）。 - **2026-04-28** 🚀 **v0.1.6 リリース**（`pip install -U vibe-trading-ai`）: `pip install` / `uv tool install` 後に `vibe-trading --swarm-presets` が空を返す問題を修正（[#55](https://github.com/HKUDS/Vibe-Trading/issues/55)）— プリセット YAML を `src.swarm` パッケージ内に同梱、6 件の回帰テストでピン留め。加えて AKShare ローダーが ETF（`510300.SH`）と外国為替（`USDCNH`）を正しいエンドポイントにルーティング、レジストリフォールバックも強化。v0.1.5 以降の更新を集約: ベンチマーク比較パネル、`/upload` ストリーミング + サイズ制限、Futu ローダー（HK + A 株）、vnpy エクスポートスキル、セキュリティ強化、フロントエンド遅延ロード（688KB → 262KB）。 - **2026-04-27** 📊 **ベンチマーク比較パネル + アップロード安全性**: バックテスト出力にベンチマーク比較パネル（銘柄 / ベンチマークリターン / 超過リターン / 情報比率）を追加、yfinance 経由で SPY・CSI 300 などを解決（[#48](https://github.com/HKUDS/Vibe-Trading/issues/48)）。加えて `/upload` を 1MB チャンクのストリーミングに変更し、`MAX_UPLOAD_SIZE` を超えた時点で中断 + 部分ファイルをクリーンアップ。50MB 上限が悪意/巨大リクエスト下でも実効化（[#53](https://github.com/HKUDS/Vibe-Trading/pull/53)）—— 4 件の回帰テストでピン留め。 - **2026-04-22** 🛡️ **ハードニング + 新規連携**: `safe_path` でパス封じ込めを強制 + 取引明細/シャドウアカウント系ツールをサンドボックス化、`MANIFEST.in` を追加して sdist に `.env.example` / テスト / Docker ファイルを同梱、フロントエンドのルート単位遅延ロードで初期バンドル 688KB → 262KB。加えて富途（Futu）の香港株/A 株データローダー（[#47](https://github.com/HKUDS/Vibe-Trading/pull/47)）と vnpy CtaTemplate エクスポートスキル（[#46](https://github.com/HKUDS/Vibe-Trading/pull/46)）を追加。 - **2026-04-21** 🛡️ **ワークスペース + ドキュメント**: 相対 `run_dir` をアクティブな run ディレクトリに正規化（[#43](https://github.com/HKUDS/Vibe-Trading/pull/43)）。README に使用例を追加（[#45](https://github.com/HKUDS/Vibe-Trading/pull/45)）。 - **2026-04-20** 🔌 **推論モデル + Swarm 修正**: `reasoning_content` を `ChatOpenAI` の全シリアライズパスで保持 — Kimi / DeepSeek / Qwen thinking がエンドツーエンドで動作（[#39](https://github.com/HKUDS/Vibe-Trading/issues/39)）。Swarm をストリーミング化 + Ctrl+C のクリーン終了（[#42](https://github.com/HKUDS/Vibe-Trading/issues/42)）。 - **2026-04-19** 📦 **v0.1.5**: PyPI と ClawHub に公開。`python-multipart` CVE 下限バンプ、新規 MCP ツール5つ接続（`analyze_trade_journal` + シャドウアカウント系4つ）、`pattern_recognition` → `pattern` レジストリ名の不一致を修正、Docker 依存を本体に合わせる、SKILL マニフェスト同期（22 MCP ツール / 71 スキル）。 - **2026-04-18** 👥 **シャドウアカウント Shadow Account**: ブローカーの取引明細から自分の戦略ルールを抽出 → マーケット横断でシャドウをバックテスト → 8セクションのHTML/PDFレポートが、どこでいくら取りこぼしたか（ルール違反・早すぎる利確・見逃したシグナル・逆張り）を正確に可視化。新規ツール4つ、新スキル1つ、合計32ツール。Trade Journal / Shadow Accountのサンプル例文がWeb UIウェルカム画面に追加。 - **2026-04-17** 📊 **取引明細アナライザー + ユニバーサルファイルリーダー**: ブローカーの取引明細（同花順/東方財富/富途/汎用CSV）をアップロード → 取引プロフィール（保有日数、勝率、損益比、最大ドローダウン）+ 4つの行動バイアス診断（処分効果、過剰取引、追随買い、アンカリング）を自動生成。`read_document`はPDF、Word、Excel、PowerPoint、画像（OCR）、40+テキスト形式を1回の呼び出しで統一処理。 - **2026-04-16** 🧠 **エージェントハーネス**: クロスセッション永続メモリ、FTS5セッション検索、自己進化スキル（完全CRUD）、5層コンテキスト圧縮、読み書きツールバッチ処理。27ツール、107新テスト。 - **2026-04-15** 🤖 **Z.ai + MiniMax**: Z.aiプロバイダー追加（[#35](https://github.com/HKUDS/Vibe-Trading/pull/35)）、MiniMax temperature修正+モデル更新（[#33](https://github.com/HKUDS/Vibe-Trading/pull/33)）。13プロバイダー対応。 - **2026-04-14** 🔧 **MCP安定性**: バックテストツールのstdioトランスポートにおける`Connection closed`エラーを修正（[#32](https://github.com/HKUDS/Vibe-Trading/pull/32)）。 - **2026-04-13** 🌐 **クロスマーケット複合バックテスト**: 新`CompositeEngine`で異なる市場の銘柄（例：A株＋暗号資産）を共有資金プールで同時バックテスト、市場ルールは銘柄ごとに適用。Swarmテンプレート変数フォールバックとフロントエンドタイムアウトも修正。 - **2026-04-12** 🌍 **マルチプラットフォーム出力**: `/pine`でTradingView (Pine Script v6)、TDX（通達信/同花順/東方財富）、MetaTrader 5 (MQL5) に一括エクスポート。 - **2026-04-11** 🛡️ **信頼性とDX**: `vibe-trading init` .envブートストラップ（[#19](https://github.com/HKUDS/Vibe-Trading/pull/19)）、プリフライトチェック、データソースフォールバック、バックテストエンジン強化。多言語README（[#21](https://github.com/HKUDS/Vibe-Trading/pull/21)）。 - **2026-04-10** 📦 **v0.1.4**: Docker修正（[#8](https://github.com/HKUDS/Vibe-Trading/issues/8)）、`web_search` MCPツール、12 LLMプロバイダー、`akshare`/`ccxt`依存追加。PyPIとClawHubに公開。 - **2026-04-09** 📊 **Backtest Wave 2**: ChinaFutures、GlobalFutures、Forex、Options v2エンジン追加。モンテカルロ、Bootstrap CI、ウォークフォワード検証。 - **2026-04-08** 🔧 **マルチマーケットバックテスト**: 市場別ルール、Pine Script v6エクスポート、自動フォールバック付き5データソース。

--- ## 💡 Vibe-Tradingとは？ Vibe-Tradingは、自然言語リクエストをグローバル市場向けの実行可能なトレーディング戦略、リサーチ洞察、ポートフォリオ分析へと変換する、AI駆動のマルチエージェント金融ワークスペースです。 ### 主な能力: • **自然言語 → 戦略** — アイデアを記述するだけ、エージェントがコードの作成・テスト・エクスポートを実行
• **6データソース、ゼロ設定** — A株、HK/US、暗号、先物、FX対応、自動フォールバック
• **29の専門チーム** — 投資・トレーディング・リスク向けマルチエージェントスウォームワークフロー
• **クロスセッションメモリ** — ユーザーの好みやインサイトを記憶し、再利用可能なスキルを自動生成・進化
• **7つのバックテストエンジン** — クロスマーケット複合テスト + 統計検証 + 4種オプティマイザー
• **マルチプラットフォームエクスポート** — ワンクリックでTradingView、TDX、MetaTrader 5へ --- ## ✨ 主な機能

🔍 トレーディング向けDeepResearch

• 74の専門スキル + クロスセッション永続メモリ
• 自己進化: エージェントが経験からワークフローを構築・改善
• 5層コンテキスト圧縮 — 長い会話でも情報損失なし
• 全金融ドメインにわたる自然言語タスクルーティング

🐝 スウォームインテリジェンス

• 即戦力の29種トレーディングチームプリセット
• DAGベースのマルチエージェントオーケストレーション
• リアルタイムストリーミングダッシュボード（エージェントステータス表示）
• FTS5クロスセッション検索で過去の全会話を横断検索

📊 クロスマーケットバックテスト

• A株、HK/US株式、暗号資産、先物、FXに対応
• 7つの市場エンジン + クロスマーケット複合エンジン（共有資金プール）
• 統計的検証: モンテカルロ、ブートストラップCI、ウォークフォワード
• 15以上のパフォーマンス指標と4種類のオプティマイザー

🧮 クオンツ分析ツールキット

• ファクターIC/IR分析と分位バックテスト
• ブラック–ショールズ価格と完全なギリシャ計算
• テクニカルパターンの認識と検出
• MVO/リスクパリティ/BLによるポートフォリオ最適化

## 8カテゴリにわたる74スキル - 📊 74の金融特化スキルを8カテゴリに整理 - 🌐 伝統的市場から暗号・DeFiまで完全カバー - 🔬 データ取得からクオンツリサーチまでの包括的能力 | Category | Skills | Examples | |----------|--------|----------| | Data Source | 6 | `data-routing`, `tushare`, `yfinance`, `okx-market`, `akshare`, `ccxt` | | 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 | 10 | `backtest-diagnose`, `report-generate`, `pine-script`, `doc-reader`, `web-reader`, `vnpy-export` | | Risk Analysis | 1 | `ashare-pre-st-filter` | ## 29種のエージェントスウォームチームプリセット - 🏢 即利用できる29種のエージェントチーム - ⚡ 事前構成された金融ワークフロー - 🎯 投資・トレーディング・リスク管理のプリセット | Preset | Workflow | |--------|----------| | `investment_committee` | 強気/弱気ディベート → リスクレビュー → PM最終判断 | | `global_equities_desk` | A株 + HK/US + 暗号研究者 → グローバルストラテジスト | | `crypto_trading_desk` | ファンディング/ベーシス + 清算 + フロー → リスクマネージャー | | `earnings_research_desk` | ファンダメンタル + リビジョン + オプション → 決算ストラテジスト | | `macro_rates_fx_desk` | 金利 + FX + コモディティ → マクロPM | | `quant_strategy_desk` | スクリーニング + ファクターリサーチ → バックテスト → リスク監査 | | `technical_analysis_panel` | クラシックTA + 一目均衡表 + ハーモニック + エリオット + SMC → コンセンサス | | `risk_committee` | ドローダウン + テイルリスク + レジームレビュー → サインオフ | | `global_allocation_committee` | A株 + 暗号 + HK/US → クロスマーケット配分 | _{さらに20以上の専門プリセット — `vibe-trading --swarm-presets`で全プリセットを確認できます。} ### 🎬 デモ

https://github.com/user-attachments/assets/4e4dcb80-7358-4b9a-92f0-1e29612e6e86	https://github.com/user-attachments/assets/3754a414-c3ee-464f-b1e8-78e1a74fbd30
_{☝️ 自然言語バックテスト＆マルチエージェントスウォームディベート — Web UI + CLI}

--- ## 🚀 クイックスタート ### ワンラインインストール（PyPI） ```bash pip install vibe-trading-ai ``` > **パッケージ名とコマンド:** PyPIパッケージは`vibe-trading-ai`。インストール後に3つのコマンドが使えます: > > | Command | Purpose | > |---------|---------| > | `vibe-trading` | 対話型CLI / TUI | > | `vibe-trading serve` | FastAPIウェブサーバー起動 | > | `vibe-trading-mcp` | MCPサーバー起動（Claude Desktop, OpenClaw, Cursorなど） | ```bash vibe-trading init # 対話的な.envセットアップ vibe-trading # CLI起動 vibe-trading serve --port 8899 # Web UI起動 vibe-trading-mcp # MCPサーバー（stdio）起動 ``` ### 使い方を選ぶ | Path | Best for | Time | |------|----------|------| | **A. Docker** | 今すぐ試す、ローカル設定ゼロ | 2分 | | **B. Local install** | 開発、フルCLIアクセス | 5分 | | **C. MCP plugin** | 既存エージェントへ組み込み | 3分 | | **D. ClawHub** | クローン不要のワンコマンド | 1分 | ### 前提条件 - サポートされる任意のプロバイダーの**LLM APIキー** — もしくは**Ollama**でローカル実行（キー不要） - Path Bでは**Python 3.11+** - Path Aでは**Docker** > **サポートされるLLMプロバイダー:** OpenRouter, OpenAI, DeepSeek, Gemini, Groq, DashScope/Qwen, Zhipu, Moonshot/Kimi, MiniMax, Xiaomi MIMO, Z.ai, Ollama（ローカル）。設定は`.env.example`を参照。 > **Tip:** すべての市場でAPIキーなしでも動作（自動フォールバック）。yfinance（HK/US）、OKX（暗号）、AKShare（A株・US・HK・先物・FX）は無料。Tushareトークンは任意 — A株はAKShareで無料フォールバック。 ### Path A: Docker（セットアップ不要） ```bash git clone https://github.com/HKUDS/Vibe-Trading.git cd Vibe-Trading cp agent/.env.example agent/.env # agent/.envを編集 — 利用するLLMプロバイダーのキーを設定 docker compose up --build ``` `http://localhost:8899`を開きます。バックエンドとフロントエンドを1コンテナで提供。 Dockerは既定でバックエンドを`127.0.0.1:8899`にのみ公開し、非rootコンテナユーザーでアプリを実行します。APIを自分のマシン外へ意図的に公開する場合は、強い`API_AUTH_KEY`を設定し、クライアントから`Authorization: Bearer `を送ってください。 ### Path B: ローカルインストール ```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.ps1 # Windows PowerShell pip install -e . cp agent/.env.example agent/.env # 編集 — LLMプロバイダーのAPIキーを設定 vibe-trading # 対話型TUIを起動 ```

Web UIを起動（任意）

```bash # Terminal 1: APIサーバー vibe-trading serve --port 8899 # Terminal 2: フロントエンド開発サーバー cd frontend && npm install && npm run dev ``` `http://localhost:5899`を開きます。フロントエンドは`localhost:8899`へAPIプロキシします。 **本番モード（単一サーバー）:** ```bash cd frontend && npm run build && cd .. vibe-trading serve --port 8899 # FastAPIがdist/を静的配信 ```

### Path C: MCP プラグイン下記の[MCP プラグイン](#-mcp-プラグイン)セクションを参照。 ### Path D: ClawHub（ワンコマンド） ```bash npx clawhub@latest install vibe-trading --force ``` スキル＋MCP設定がエージェントのskillsディレクトリにダウンロードされます。詳細は[MCP プラグイン](#-mcp-プラグイン)を参照。 --- ## 🧠 環境変数 `agent/.env.example`を`agent/.env`へコピーし、使いたいプロバイダーのブロックをアンコメント。各プロバイダーは3〜4変数を使用: | Variable | Required | Description | |----------|:--------:|-------------| | `LANGCHAIN_PROVIDER` | Yes | プロバイダー名（`openrouter`, `deepseek`, `groq`, `ollama` など） | | `_API_KEY` | Yes* | APIキー（`OPENROUTER_API_KEY`, `DEEPSEEK_API_KEY` など） | | `_BASE_URL` | Yes | APIエンドポイントURL | | `LANGCHAIN_MODEL_NAME` | Yes | モデル名（例: `deepseek/deepseek-v3.2`） | | `TUSHARE_TOKEN` | No | A株データ用Tushare Proトークン（AKShareにフォールバック） | | `TIMEOUT_SECONDS` | No | LLM呼び出しタイムアウト（既定120s） | | `API_AUTH_KEY` | ネットワークデプロイでは推奨 | APIが非ローカルクライアントから到達可能な場合に必要なBearer token | | `VIBE_TRADING_ENABLE_SHELL_TOOLS` | No | リモートAPI / MCP-SSE系デプロイでshell系ツールを明示的に有効化 | | `VIBE_TRADING_ALLOWED_FILE_ROOTS` | No | 文書・ブローカー取引明細インポート用の追加ルート（カンマ区切り） | | `VIBE_TRADING_ALLOWED_RUN_ROOTS` | No | 生成コードrunディレクトリ用の追加ルート（カンマ区切り） | _{* OllamaはAPIキー不要。} **無料データ（キー不要）:** AKShare経由のA株、yfinance経由のHK/US株式、OKX経由の暗号、CCXT経由の100+暗号取引所。市場ごとに最適なソースを自動選択。 ### 🎯 推奨モデル Vibe-Tradingはツール呼び出しに大きく依存するエージェントです — skill・バックテスト・メモリ・swarmはすべてtool callで動作します。モデル選択が、エージェントが**実際にツールを使う**か、訓練データから答えを捏造するかを直接決定します。 | 層 | 例 | 用途 | |----|-----|------| | **ベスト** | `anthropic/claude-opus-4.7`、`anthropic/claude-sonnet-4.6`、`openai/gpt-5.4`、`google/gemini-3.1-pro-preview` | 複雑なswarm（3+エージェント）、長い研究セッション、論文レベル分析 | | **コスパ**（デフォルト） | `deepseek/deepseek-v3.2`、`x-ai/grok-4.20`、`z-ai/glm-5.1`、`moonshotai/kimi-k2.5`、`qwen/qwen3-max-thinking` | 日常利用 — tool-callingが安定、コスト約1/10 | | **エージェント用途では非推奨** | `*-nano`、`*-flash-lite`、`*-coder-next`、小型 / 蒸留版 | tool-callingが不安定 — skillのロードやbacktest実行をせず「記憶で回答」してしまう | デフォルトの `agent/.env.example` は `deepseek/deepseek-v3.2` — コスパ層の最安オプション。 --- ## 🖥 CLI リファレンス ```bash vibe-trading # 対話型TUI vibe-trading run -p "..." # シングル実行 vibe-trading serve # APIサーバー ```

TUI内スラッシュコマンド

| Command | Description | |---------|-------------| | `/help` | すべてのコマンドを表示 | | `/skills` | 74の金融スキルを一覧表示 | | `/swarm` | 29のスウォームチームプリセットを一覧表示 | | `/swarm run [vars_json]` | スウォームチームをライブストリーミングで実行 | | `/swarm list` | スウォーム実行履歴 | | `/swarm show ` | スウォーム実行の詳細 | | `/swarm cancel ` | 実行中スウォームをキャンセル | | `/list` | 直近の実行 | | `/show ` | 実行詳細と指標 | | `/code ` | 生成された戦略コード | | `/pine ` | インジケーターエクスポート（TradingView + TDX + MT5）| | `/trace ` | 実行リプレイ | | `/continue ` | 実行を新指示で継続 | | `/sessions` | チャットセッション一覧 | | `/settings` | 実行時設定を表示 | | `/clear` | 画面クリア | | `/quit` | 終了 |

単発実行とフラグ

```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 # インジケーターエクスポート（TradingView + TDX + MT5） vibe-trading --trace vibe-trading --continue "refine the strategy" vibe-trading --upload report.pdf ```

--- ## 🌐 API サーバー ```bash vibe-trading serve --port 8899 ``` | Method | Endpoint | Description | |--------|----------|-------------| | `GET` | `/runs` | 実行一覧 | | `GET` | `/runs/{run_id}` | 実行詳細 | | `GET` | `/runs/{run_id}/pine` | マルチプラットフォームインジケーターエクスポート | | `POST` | `/sessions` | セッション作成 | | `POST` | `/sessions/{id}/messages` | メッセージ送信 | | `GET` | `/sessions/{id}/events` | SSEイベントストリーム | | `POST` | `/upload` | PDF/ファイルのアップロード | | `GET` | `/swarm/presets` | スウォームプリセット一覧 | | `POST` | `/swarm/runs` | スウォーム実行開始 | | `GET` | `/swarm/runs/{id}/events` | スウォームSSEストリーム | | `GET` | `/settings/llm` | Web UIのLLM設定を読み取り | | `PUT` | `/settings/llm` | ローカルLLM設定を更新 | | `GET` | `/settings/data-sources` | ローカルデータソース設定を読み取り | | `PUT` | `/settings/data-sources` | ローカルデータソース設定を更新 | インタラクティブドキュメント: `http://localhost:8899/docs` ### セキュリティ既定値 localhost開発では、`vibe-trading serve`はブラウザワークフローをシンプルに保ちます。非ローカルクライアントから機密APIへアクセスする場合は`API_AUTH_KEY`が必要です。JSON/アップロードリクエストでは`Authorization: Bearer `を使ってください。ブラウザEventSourceストリームは、Web UIのSettingsで同じキーを一度入力すると処理されます。 shell系ツールはローカルCLIと信頼済みlocalhostワークフローでは利用できますが、リモートAPIセッションには既定で公開されません。必要な場合のみ`VIBE_TRADING_ENABLE_SHELL_TOOLS=1`を明示的に設定してください。文書・取引明細リーダーは既定でアップロード/インポートルートに制限されます。ファイルは`agent/uploads`、`agent/runs`、`./uploads`、`./data`、`~/.vibe-trading/uploads`、`~/.vibe-trading/imports`へ置くか、`VIBE_TRADING_ALLOWED_FILE_ROOTS`で専用ディレクトリを追加してください。 ### Web UI Settings Web UI Settingsページでは、ローカルユーザーがLLM provider/model、Base URL、生成パラメータ、reasoning effort、Tushare tokenなどの任意の市場データ認証情報を更新できます。設定は`agent/.env`に保存され、providerのデフォルト値は`agent/src/providers/llm_providers.json`から読み込まれます。 Settingsの読み取りは副作用なしです。`GET /settings/llm`と`GET /settings/data-sources`は`agent/.env`を作成せず、プロジェクト相対パスのみを返します。Settingsの読み取り/書き込みは認証情報の状態を公開したり認証情報・実行時環境を更新したりする可能性があるため、`API_AUTH_KEY`が設定されている場合は認証が必要です。開発モードで`API_AUTH_KEY`が未設定の場合、settingsアクセスはloopbackローカルクライアントのみに許可されます。 --- ## 🔌 MCP プラグイン Vibe-Tradingは、あらゆるMCP互換クライアント向けに22のMCPツールを提供します。stdioサブプロセスとして実行 — サーバーセットアップ不要。**22中21ツールはAPIキー不要**（HK/US/暗号）。`run_swarm`のみLLMキーが必要。

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 / 他MCPクライアント

```bash vibe-trading-mcp # stdio（デフォルト） vibe-trading-mcp --transport sse # Webクライアント向けSSE ```

**公開MCPツール（22）:** `list_skills`, `load_skill`, `backtest`, `factor_analysis`, `analyze_options`, `pattern_recognition`, `get_market_data`, `web_search`, `read_url`, `read_document`, `read_file`, `write_file`, `analyze_trade_journal`, `extract_shadow_strategy`, `run_shadow_backtest`, `render_shadow_report`, `scan_shadow_signals`, `list_swarm_presets`, `run_swarm`, `get_swarm_status`, `get_run_result`, `list_runs`。

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

```bash npx clawhub@latest install vibe-trading --force ``` > 外部APIを参照するためVirusTotalの自動スキャンが走るので`--force`が必要。コードは完全オープンソースで検証可能。スキル＋MCP設定がエージェントのskillsディレクトリにダウンロードされます。クローン不要。 ClawHubで閲覧: [clawhub.ai/skills/vibe-trading](https://clawhub.ai/skills/vibe-trading)

OpenSpace — 自己進化スキル

全74金融スキルは[open-space.cloud](https://open-space.cloud)に公開され、OpenSpaceの自己進化エンジンで自律的に進化します。 OpenSpaceで使うには、両方のMCPサーバーをエージェント設定に追加: ```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が全74スキルを自動検出し、auto-fix/auto-improve/コミュニティ共有を有効化。`search_skills("finance backtest")`でVibe-Tradingスキルを検索可能。

--- ## 📁 プロジェクト構成

クリックして展開

``` Vibe-Trading/ ├── agent/ # バックエンド (Python) │ ├── cli.py # CLIエントリーポイント — 対話型TUI + サブコマンド │ ├── api_server.py # FastAPIサーバー — runs, sessions, upload, swarm, SSE │ ├── mcp_server.py # MCPサーバー — OpenClaw / Claude Desktop向け22ツール │ │ │ ├── src/ │ │ ├── agent/ # ReActエージェントコア │ │ │ ├── loop.py # 5層圧縮 + 読み書きツールバッチ処理 │ │ │ ├── context.py # システムプロンプト + 永続メモリからの自動リコール │ │ │ ├── skills.py # スキルローダー（74バンドル + ユーザーCRUD作成） │ │ │ ├── tools.py # ツール基底クラス + レジストリ │ │ │ ├── memory.py # 実行ごとの軽量ワークスペースステート │ │ │ ├── frontmatter.py # 共有YAMLフロントマターパーサー │ │ │ └── trace.py # 実行トレースライター │ │ │ │ │ ├── memory/ # クロスセッション永続メモリ │ │ │ └── persistent.py # ファイルベースメモリ (~/.vibe-trading/memory/) │ │ │ │ │ ├── tools/ # 27の自動検出エージェントツール │ │ │ ├── backtest_tool.py # バックテスト実行 │ │ │ ├── remember_tool.py # クロスセッションメモリ (保存/リコール/削除) │ │ │ ├── skill_writer_tool.py # スキルCRUD (保存/パッチ/削除/ファイル) │ │ │ ├── session_search_tool.py # FTS5クロスセッション検索 │ │ │ ├── swarm_tool.py # スウォームチーム起動 │ │ │ ├── web_search_tool.py # DuckDuckGoウェブ検索 │ │ │ └── ... # bash, ファイルI/O, ファクター分析, オプション等 │ │ │ │ │ ├── skills/ # 8カテゴリに渡る74金融スキル (各SKILL.md) │ │ ├── swarm/ # スウォームDAG実行エンジン │ │ │ └── presets/ # 29のスウォームプリセットYAML定義 │ │ ├── session/ # マルチターンチャット + FTS5セッション検索 │ │ └── providers/ # LLMプロバイダー抽象化 │ │ │ └── backtest/ # バックテストエンジン │ ├── engines/ # 7エンジン + クロスマーケット複合エンジン + options_portfolio │ ├── loaders/ # 6ソース: tushare, okx, yfinance, akshare, ccxt, futu │ │ ├── base.py # DataLoader Protocol │ │ └── registry.py # レジストリ + 自動フォールバックチェーン │ └── optimizers/ # MVO, equal vol, max div, risk parity │ ├── frontend/ # Web UI (React 19 + Vite + TypeScript) │ └── src/ │ ├── pages/ # Home, Agent, RunDetail, Compare │ ├── components/ # chat, charts, layout │ └── stores/ # Zustandステート管理 │ ├── Dockerfile # マルチステージビルド ├── docker-compose.yml # ワンコマンドデプロイ ├── pyproject.toml # パッケージ設定 + CLIエントリーポイント └── LICENSE # MIT ```

--- ## 🏛 エコシステム Vibe-Tradingは**[HKUDS](https://github.com/HKUDS)**エージェントエコシステムの一部です:

ClawTeam
_{エージェントスウォームインテリジェンス}

NanoBot
_{超軽量パーソナルAIアシスタント}

CLI-Anything
_{すべてのソフトウェアをエージェントネイティブに}

OpenSpace
_{自己進化型AIエージェントスキル}

--- ## 🗺 ロードマップ > 段階的にリリースします。作業開始時に[Issues](https://github.com/HKUDS/Vibe-Trading/issues)へ移動します。 | Phase | Feature | Status | |-------|---------|--------| | **Research Autopilot** | 夜間リサーチループ: 仮説 → データ取得 → バックテスト → 証拠レポート | In Progress | | **Data Bridge** | 持ち込みデータ: ローカル CSV/Parquet/SQL コネクタ + schema mapping | Planned | | **Options Lab** | ボラティリティサーフェス、Greeks ダッシュボード、損益/シナリオ探索 | Planned | | **Portfolio Studio** | リスクX線、制約、回転率考慮オプティマイザー、リバランスノート | Planned | | **Alpha Zoo** | Alpha101 / Alpha158 / Alpha191 因子ライブラリ、スクリーニング + IC テスト | Planned | | **Research Delivery** | Slack / Telegram / メール型チャネルへの定期ブリーフ配信 | Planned | | **Trust Layer** | 再現可能な run card: ツール履歴、データソース、仮定、引用 | Planned | | **Community** | 共有可能な skills、presets、strategy cards | Exploring | --- ## 貢献貢献を歓迎します！ガイドラインは[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)タグ付き — どれか選んで始めてください。より大きな貢献を検討中ですか？上記[ロードマップ](#-ロードマップ)を確認し、着手前にIssueで相談してください。 --- ## コントリビューター Vibe-Tradingに貢献してくださった皆さんに感謝します！

--- ## 免責事項 Vibe-Tradingはリサーチ・シミュレーション・バックテスト用途のみです。投資助言ではなく、リアルトレードを実行しません。過去の実績は将来の結果を保証しません。 ## ライセンス MIT License — [LICENSE](LICENSE)を参照 --- ## スター履歴 [![Star History Chart](https://api.star-history.com/svg?repos=HKUDS/Vibe-Trading&type=Date)](https://star-history.com/#HKUDS/Vibe-Trading&Date) ---

Vibe-Tradingへの訪問に感謝 ✨