インストール¶
alpha-visualizer は PyPI で配布されています。Python 3.12 以上が必要です。
alpha-forge と一緒に使う
alpha-visualizer は forge 本体（バックテストエンジン）とは独立してインストール・実行できますが、可視化対象である backtest_results.db は forge が生成します。forge のインストールがまだの場合は AlphaForge スタートガイド を参照してください（最新バイナリは GitHub Releases からも取得可能）。
動作要件¶
| 項目 | バージョン |
|---|---|
| Python | 3.12 以上 |
| OS | macOS / Linux / Windows |
| ブラウザ | Chrome / Firefox / Safari / Edge の最新版 |
uv（推奨）¶
uv を使うと専用のツール環境にインストールでき、Python のバージョン競合を気にせず使えます。
uv 自体の導入が必要な場合は https://docs.astral.sh/uv/getting-started/installation/ を参照してください。
pip¶
通常の Python 環境にインストールする場合：
仮想環境内へのインストール例：
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install alpha-visualizer
ソースから（開発者向け）¶
GitHub から clone してローカルで動作させる場合：
git clone https://github.com/alforge-labs/alpha-visualizer.git
cd alpha-visualizer
uv sync # Python 依存関係
cd frontend && pnpm install && pnpm run build && cd ..
uv run vis serve --forge-dir <path>
開発フローの詳細は CONTRIBUTING.md を参照してください。
インストール確認¶
正常にインストールされていれば、バージョン番号が表示されます。