alpha-visualizer
English | 日本語
AlphaForge のバックテスト結果を Web ブラウザで可視化するスタンドアロンツール — JSON で戦略を記述し、Optuna TPE で最適化、ウォークフォワード検証して TradingView Pine v6 にエクスポート。AI エージェントがパイプライン全体を駆動できる、ローカルファースト Quant CLI です。→ AlphaForge を無料で試す
alpha-visualizer は、AlphaForge のバックテストエンジンが出力する backtest_results.db（SQLite）と戦略 JSON を直接読み取り、ブラウザベースのダッシュボードとして可視化します。alpha-vis serve 一発で FastAPI + React SPA が起動し、戦略の閲覧・比較・最適化結果の確認・ライブ実績との突き合わせまでを行えます。
0.3.0 で破壊的変更: コマンド名を
vis→alpha-visにリネームしました。macOS 標準の/usr/bin/vis（BSD 系テキスト可視化ユーティリティ）と衝突して、旧vis serveコマンドがvis: serve: No such file or directoryなどになる初学者の詰まりを解消するためです。詳細は CHANGELOG を参照してください。
主な機能
- Browse — 戦略ライブラリの一覧と検索（Symbol Coverage / Saved Views / Strategy Ledger）
- Detail — Equity / Drawdown / 取引履歴・ベンチマーク（alpha / beta / IR / Correlation）
- Compare — 複数戦略の指標比較と相関ヒートマップ
- Optimize — WFO 合成エクイティカーブ・Grid 最適化結果の可視化
- Live — バックテストとライブ実績の期間整合 diff
- Ideas — 探索アイデアの一覧（ステータス・タグフィルタ）
- Maintenance — 孤児バックテスト結果（strategies.db に定義の無い実行結果）の一覧・選択削除
- テーマ切替 — ダーク/ライトモード、日英バイリンガル UI
- エクスポート — CSV / PNG エクスポート、SNS シェアカード（equity curve＋主要指標入り OGP サイズ PNG）、URL 共有（Browse の selectedId / compareIds 同期）
クイックスタート
インストール
# uv（推奨）
uv pip install alpha-visualizer
# pip
pip install alpha-visualizer
起動
# AlphaForge の作業ディレクトリで（backtest_results.db / strategies/ がある場所）
alpha-vis serve
# パスを明示する場合
alpha-vis serve --forge-dir /path/to/alpha-strategies
# ポート・ホスト指定
alpha-vis serve --port 9000 --host 0.0.0.0
# ブラウザを自動で開かない
alpha-vis serve --no-open
ブラウザで http://127.0.0.1:8000 が開きます。Ctrl+C で停止します。
環境変数
| 変数名 | 役割 |
|---|---|
FORGE_CONFIG |
forge.yaml への絶対パス。--forge-dir 引数より優先される（探索順序: 引数 config_path → FORGE_CONFIG → <forge_dir>/forge.yaml） |
VITE_API_PROXY |
フロント開発サーバーの API proxy 先（既定 http://127.0.0.1:8000） |
ALPHA_VIS_RUN_TIMEOUT |
POST /api/run（バックテスト再実行）の forge CLI タイムアウト秒数（既定 600） |
ALPHA_VIS_JOB_TIMEOUT |
非同期ジョブ（POST /api/jobs、optimize / WFT / backtest）のタイムアウト秒数（既定 3600） |
ALPHA_VIS_JOB_CONCURRENCY |
非同期ジョブの同時実行数（既定 1。バックテストエンジンは CPU 集約のため増やす場合は注意） |
開発時に予期せぬ forge.yaml が参照されている場合は unset FORGE_CONFIG で解除してください。手元で alpha-vis serve --forge-dir /path/to/A を打ったのに別ディレクトリの DB が読まれているときは、ほぼこの環境変数が原因です。
スクリーンショット
| Detail | Compare |
|---|---|
 |
 |
Compare — 戦略間相関ヒートマップ
| Optimize | Strategy 構造 |
|---|---|
 |
 |
ドキュメント
- 公式ドキュメント: https://alforgelabs.com/ja/docs/alpha-visualizer/
- 開発に参加: CONTRIBUTING.md
- セキュリティ報告: SECURITY.md
- 行動規範: CODE_OF_CONDUCT.md（Contributor Covenant v2.1）
- 変更履歴: CHANGELOG.md
- サードパーティライセンス: THIRDPARTY_LICENSES.txt
関連プロジェクト
- Alforge Labs — AlphaForge 公式サイト・チュートリアル
- AlphaForge — バックテストエンジン本体（商用ライセンス）
開発環境
# 依存関係インストール
uv sync
# テスト・Lint
uv run pytest tests/ -v
uv run ruff check src/ tests/
# フロントエンド開発サーバー（ホットリロード）
cd frontend && pnpm install && pnpm run dev
# フロントエンドビルド（src/alpha_visualizer/static/ に出力）
cd frontend && pnpm run build
詳細は CONTRIBUTING.md を参照してください。
ライセンス
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file alpha_visualizer-1.2.1.tar.gz.
File metadata
- Download URL: alpha_visualizer-1.2.1.tar.gz
- Upload date:
- Size: 4.7 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0eaa2b2f6c17a7d8e0c0202ac712ae2daedab6ec69ac2ab5ad12af8a30d19a47
|
|
| MD5 |
977a3f6ae35d2ba162d804b29009faba
|
|
| BLAKE2b-256 |
01371cf0f3d6b518efcba251d20afd58e661404863a101dae91fa9e538da8970
|
Provenance
The following attestation bundles were made for alpha_visualizer-1.2.1.tar.gz:
Publisher:
release.yml on alforge-labs/alpha-visualizer
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
alpha_visualizer-1.2.1.tar.gz -
Subject digest:
0eaa2b2f6c17a7d8e0c0202ac712ae2daedab6ec69ac2ab5ad12af8a30d19a47 - Sigstore transparency entry: 2271470020
- Sigstore integration time:
-
Permalink:
alforge-labs/alpha-visualizer@2fb6fdbc38974b4a6a25a5bb9f479b7e6792cff8 -
Branch / Tag:
refs/tags/v1.2.1 - Owner: https://github.com/alforge-labs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@2fb6fdbc38974b4a6a25a5bb9f479b7e6792cff8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file alpha_visualizer-1.2.1-py3-none-any.whl.
File metadata
- Download URL: alpha_visualizer-1.2.1-py3-none-any.whl
- Upload date:
- Size: 2.4 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e9ad364a2a9929e82ec8e0549fb0d0733c883257865074919de0908597c78919
|
|
| MD5 |
b1231ab4b2624a9b7a61bbb4098eb68b
|
|
| BLAKE2b-256 |
74f365ce7574bb3e64744d3aa2624e7e1ff353ad1e56f0789526884aee939fd3
|
Provenance
The following attestation bundles were made for alpha_visualizer-1.2.1-py3-none-any.whl:
Publisher:
release.yml on alforge-labs/alpha-visualizer
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
alpha_visualizer-1.2.1-py3-none-any.whl -
Subject digest:
e9ad364a2a9929e82ec8e0549fb0d0733c883257865074919de0908597c78919 - Sigstore transparency entry: 2271470785
- Sigstore integration time:
-
Permalink:
alforge-labs/alpha-visualizer@2fb6fdbc38974b4a6a25a5bb9f479b7e6792cff8 -
Branch / Tag:
refs/tags/v1.2.1 - Owner: https://github.com/alforge-labs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@2fb6fdbc38974b4a6a25a5bb9f479b7e6792cff8 -
Trigger Event:
push
-
Statement type:
