alpha-visualizer

PyPI version CI Python License: Apache 2.0 Follow @Alforge_bot

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 画面

主な機能

  • 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 不要）

AlphaForge をまだ持っていなくても、同梱の合成サンプルデータで全画面を 1 コマンドで試せます:

alpha-vis serve --use-bundled-samples

40 件のバックテスト結果・WFO / Grid 最適化結果・戦略アイデアを含む自己完結の forge プロジェクト（完全合成データ・再配布フリー）が開きます。内訳は samples/README.md を参照してください。

起動

# 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
Detail Compare

Compare — 戦略間相関ヒートマップ

相関ヒートマップ

Optimize Strategy 構造
Optimize Strategy
Live（バックテスト×ライブ実績 diff） Ideas（探索アイデアボード）
Live Ideas

困ったときは

alpha-vis: command not found・backtest_results.db が見つからない・ポート衝突など、よくある詰まりの回答は公式 FAQ にまとまっています。

ドキュメント

関連プロジェクト

  • 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 を参照してください。

ライセンス

Apache License 2.0 © alforge-labs

Project links

Data verified by PyPI on Aug 1, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.7.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ysakae from gravatar.com ysakae

Credits

Author: alforge-labs

GitHub Statistics

Data verified by PyPI on Aug 1, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.12

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

alpha_visualizer-1.3.0.tar.gz (4.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

alpha_visualizer-1.3.0-py3-none-any.whl (2.5 MB view details)

Uploaded Python 3

File details

Details for the file alpha_visualizer-1.3.0.tar.gz.

File metadata

  • Download URL: alpha_visualizer-1.3.0.tar.gz
  • Upload date:
  • Size: 4.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for alpha_visualizer-1.3.0.tar.gz
Algorithm Hash digest
SHA256 bebc0a14b3dd4c09088431acd8be3658c86bbc038f67180ef8e377e64fec3b1d
MD5 f5a5e2bfd90ed05ca78d8c1d5c7831c2
BLAKE2b-256 f7aec3fb14b4625267d8444a55339d931701efca399ec3469d0b3968dc0bae41

See more details on using hashes here.

Provenance

The following attestation bundles were made for alpha_visualizer-1.3.0.tar.gz:

Publisher: release.yml on alforge-labs/alpha-visualizer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file alpha_visualizer-1.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for alpha_visualizer-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fbf461d02d4c9e7a2a1f9315b33e0133270b38fad6d31f76c9ee59f2cb891af0
MD5 5726f39a424970db4bb8d3d99f30bd3a
BLAKE2b-256 c22187aebce3d4dc77d29d3e1a0576228babb648e892ef91008321a79c90c592

See more details on using hashes here.

Provenance

The following attestation bundles were made for alpha_visualizer-1.3.0-py3-none-any.whl:

Publisher: release.yml on alforge-labs/alpha-visualizer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page