vike-cli

vike

Rust 製トレーディングプラットフォームです。ライブ実行コア、バックテストとリサーチ用ハーネス、デスクトップのチャート表示シェル、14 の取引所へのブリッジを備えています。

このリポジトリはソースミラーです。コードのみを収録しており、CI ワークフロー、運用手順書、履歴は含まれていません。公開ごとに 1 つのコミットが作成されます。開発用リポジトリは非公開で、ここにあるものがリリースバイナリのビルド元です。

含まれるもの

ライブデーモン（vike-tradehub）	ヘッドレス実行機能です。取引所をマウントして戦略を実行し、取引所との状態を照合します。休止中の板を処理したうえで、SIGTERM によって正常に停止します
バックテスト + リサーチ（backtesthub、vike-study、tearsheet）	パラメーターの総当たり、Successive Halving による絞り込み、TPE オプティマイザーを備えたバー／ティック用ハーネスです。レポートは実行マニフェストとして保存されます
デスクトップシェル（vike-desktop）	egui/wgpu をベースにした、チャート、注文入力、データマネージャー、接続エディターです。デーモンのクライアントであり、独自に取引所をマウントすることはありません
データ（vike-datahub、vike-recorder）	Parquet/DataFusion の履歴ストア、ライブレコーダー、クエリサーバーです
取引所	binance、bybit、okx、deribit、hyperliquid、aster、alpaca、ctrader、ig、oanda、polymarket、dukascopy、fxcm、ibkr。それぞれが crates/bridges/ 配下のクレートです
エージェントスキル（skills/）	vike-cli mcp を操作するエージェント向けの手順です。バックテスト、戦略の作成、データの取り込み、プレビューゲートを介したノード上での取引を扱います。各手順は 1 つの SKILL.md にまとめられ、skills/README.md にインデックスされています

実行方法

コンテナーイメージには、すべてのヘッドレスツールが 1 つのバイナリとして含まれ、ツールごとにシンボリックリンクが用意されています。

docker pull vikeio/vike-tradehub:latest      # Docker Hub
docker pull ghcr.io/vike-io/vike-tradehub    # GHCR

コマンドラインツールは、ツールチェーンなしでリリースからインストールできます（Linux と Windows に対応しています。それ以外のターゲットではクローンからコンパイルします。理由は crates/vike-cli/Cargo.toml の [package.metadata.binstall] に記載されています）。

cargo binstall --git https://github.com/vike-io/vike-trader vike-cli

Rust がまったくインストールされていない Windows 環境では、リリースから実行ファイルをダウンロードしてください。インストールは不要で、ツールチェーンも必要ありません。

curl.exe -L -o vike-cli.exe https://github.com/vike-io/vike-trader/releases/latest/download/vike-cli.exe
.\vike-cli.exe --version

実行する前に、リリースに付属するマニフェストを使って検証してください。

curl.exe -L -o SHA256SUMS https://github.com/vike-io/vike-trader/releases/latest/download/SHA256SUMS
(Get-FileHash vike-cli.exe -Algorithm SHA256).Hash.ToLower()   # compare with the vike-cli.exe line

⚠ どちらの方法でも自動更新はされません。cargo binstall は移動しないクレートバージョンのもとでインストールを記録するため、再インストールには --force が必要です。ダウンロードした実行ファイルは、再度ダウンロードして置き換えてください。

⚠ Windows 用の単体バックテスト ENGINE は公開されていないため、ビルドするまでは data hist fetch --source demo|starter と backtest run --local は利用できません。リモート経路には ENGINE は不要です。vike-cli backtest run --addr HOST:PORT を実行すると、代わりに vike-datahub サーバー上で実行されます。

ソースから実行する場合：

cargo build --workspace                      # no native dependencies on default features
cargo run -p vike-desktop                    # the desktop shell (charts stay empty with no backend)

エージェント（Claude Code、Cursor、任意の MCP クライアント）向けのスキルは、このリポジトリから直接インストールできます。

npx skills add vike-io/vike-trader           # every procedure under skills/, one SKILL.md each

新規インストールにはマーケットデータがありません — 以下の方法で解決できます

vike-cli init                              # example strategies, indicators and run profiles under user_data/
vike-cli data hist fetch --source demo     # a SYNTHETIC demo tape, written under the venue id `demo`
vike-backend datahub &                     # serves this project's store: key-less, loopback only
vike-cli backtest run --local --profile user_data/profiles/backtest.toml \
                  --script user_data/strategies/rhai/sma_cross/sma_cross.rhai

datahub は必須です。--local 実行を含め、履歴の READ はすべて datahub 経由で行われます。--local によってバックテスト ENGINE はこのマシン上に移動しますが、履歴は移動しません。環境変数を設定せずに起動すると、シード用コマンドが書き込んだものと同じ <project>/market_data/hist を提供します。また、ハブキーがなければ認証は行われず、ループバックアドレスのみをバインドします。これは --local がデフォルトで参照するアドレスです。テープを別の場所に保存した場合は、そのディレクトリを指定してください。

vike-backend datahub --store DIR   # DIR: where the tape went

デモテープは閉形式の曲線であり、マーケットデータではありません。ツールで描画や実行ができるように用意されており、独自の取引所 ID のもとに書き込まれるため、実際の行と取り違えたり、実データと集計されたりすることはありません。実際のバーを使う場合：

vike-cli data hist fetch --source starter               # the published dataset, over plain HTTPS
vike-cli data hist fetch binance:BTCUSDT:1h --days 180  # public history, no credentials; asks the datahub

認証情報と、ペーパー運用を維持するゲート

認証情報ストアは設定データベース <project>/settings/db/vike.db の1つだけです。認証情報が存在しないことが実際のゲートになります。キーのない demo または live アカウントは動作しません。各アカウントは、その account 行が有効な間に限り、自身のティア（paper、demo、live）で取引します。行がない場合、行が無効な場合、またはキーを正確に紐付けられないティアの場合は、何も動作しません。代わりにペーパー運用になることはありません。vike-cli secrets accounts で行の一覧を確認でき、vike-cli secrets account activate|deactivate|set-tier --id <N> で1つの行を変更できます。 ⚠ 認証情報はアカウントに属します。認証情報を保存しても、アカウントが作成されたり、ティアが選択されたりすることはありません。vike-cli secrets account add --venue <VENUE> --tier <paper|demo|live> --no-label で行を作成します。作成時点で有効になるため、その後キーを保持した live 行は、ライブデーモンの次回起動時にそのアカウントを有効化します。

新しい環境では、vike-cli secrets init で空のストアを作成します。vike-cli secrets set --account <ID> <FIELD> でアカウントの認証情報を1つ追加します（値は標準入力から渡し、コマンドラインには記述しません）。vike-cli secrets path でどのストアが使用されているかを表示し、vike-cli secrets list でアカウントごとに保持しているキーを確認できます。 このワークスペース内で、そのデータベース全体を削除、移動、書き換えることはありません。

ライセンス

FSL-1.1-ALv2 — ソースを利用でき、各バージョンはリリースから2年後に Apache-2.0 になります。商用利用を含め、閲覧、変更、セルフホスト、実行が可能です。また、サポートやコンサルティングに料金を請求できます。ただし、競合する製品やホスト型サービスとして提供することはできません。2年の期間が経過すると、すべてのリリースが最終的に寛容なライセンスの下で利用可能になります。

バグ、質問、または何も投稿しない場合

このページのバグや誤った記述は、 issues に投稿してください。Issue は公開され、確認されます。実行した内容、起きたこと、期待したこと、そして vike-cli --version の出力を記載してください。

使い方に関する質問は、 discussions に投稿してください。

このリポジトリで受け付けられないのはプルリクエストです。その理由は、貢献者に関する方針ではなく、構造上のものです。このミラーは SNAPSHOT であり、リリースごとに1つのコミットだけを含み、強制プッシュされ、履歴はありません。履歴を保持するミラーでは、以前のリリースで公開されなかったすべてのファイルが再び渡されてしまうためです。ここにあるブランチは、次の公開時に置き換えられます。そのため、差分を含む Issue としてパッチを投稿していただければ歓迎します。パッチは手作業で上流に反映されます。

回答できない内容：お客様のストラテジーの実行依頼、優位性が実在するかどうかの評価、フォークへのサポート依頼です。このツリー内のテストと意思決定記録が、ここで述べているすべての主張の根拠です。まずはそちらをご確認ください。