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.4.tar.gz (5.1 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.4-py3-none-any.whl (2.5 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: alpha_visualizer-1.3.4.tar.gz
  • Upload date:
  • Size: 5.1 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.4.tar.gz
Algorithm Hash digest
SHA256 f71702302e165e1513ba79e1535c5fa7bb6429e6abf418a6722533867a0e2b43
MD5 88c5860f1596ad802c0f75bd307a41aa
BLAKE2b-256 1a8d6f5d8095aee727e1c4e8e01691c1d97f1d49f42ade28ecbf8c5cc28e980f

See more details on using hashes here.

Provenance

The following attestation bundles were made for alpha_visualizer-1.3.4.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.4-py3-none-any.whl.

File metadata

File hashes

Hashes for alpha_visualizer-1.3.4-py3-none-any.whl
Algorithm Hash digest
SHA256 5bcdf5f224fb2fda121f8f9963d5f67a1104885947ada55aaaee5a4527620fe8
MD5 b048bec9ec73afaa809790ef92b62f2a
BLAKE2b-256 27b0a3684ff6b26829ad6e387b32d1d2b7dea1c17d80399c7423cbce5c308cda

See more details on using hashes here.

Provenance

The following attestation bundles were made for alpha_visualizer-1.3.4-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