branchpy-cli 1.2.3

Analyze Ren'Py projects for branching structure, assets, QA issues, and flow.

BranchPy

Analyze Ren'Py projects for branching structure, assets, QA issues, and story flow.

Local-first analysis tool for Ren'Py projects — no cloud required.

What this is

BranchPy is a developer tool for Ren'Py visual novel projects. It analyzes your project locally and generates reports covering story structure, branching paths, asset validation, and quality issues.

Used to analyze large Ren'Py projects and production-scale visual novels.

It runs from the command line and integrates with Visual Studio Code for a full visual workflow.

Installation

Install the CLI:

pip install branchpy-cli

After installation, run branchpy or bpy.

Install the VS Code extension from the Visual Studio Code Marketplace for the full visual experience (flowcharts, one-click analysis, and in-editor reports).

Quick start

# Analyze a Ren'Py project
branchpy analyze --project "/path/to/your/renpy/project"

# Generate a story flowchart
branchpy flowchart --project "/path/to/your/renpy/project"

# Run structural statistics
branchpy stats --project "/path/to/your/renpy/project"

# Validate assets
branchpy media --project "/path/to/your/renpy/project"

Both branchpy and bpy are available as CLI entry points.

Features

• Story flow analysis — detect unreachable labels, broken jumps, and structural issues
• Branching path exploration — enumerate paths through your project from configurable entry points
• Asset validation — find missing, unused, or misreferenced images and audio files
• Project statistics — structural classification (finite, loop-based, hybrid), complexity metrics, and coverage ratios
• Compare — track changes between analysis runs
• Local-first — no cloud dependency, no telemetry without consent, works offline

Some advanced features (semantic image similarity) require optional local dependencies. See https://branchpy.com/docs/ for details.

VS Code extension

Install BranchPy from the VS Code Marketplace to access:

• Interactive flowchart visualization
• One-click analysis from the Control Center
• Visual report panels (Insights, PILOT, Stats, OMEGA)
• Real-time output and error console

The extension detects the installed CLI automatically. If the CLI is not found, it shows an install prompt with the exact command.

Requirements

• Python 3.11 or higher
• A Ren'Py project directory

Links

• Website: https://branchpy.com
• Documentation: https://branchpy.com/docs/
• Changelog: https://branchpy.com/changelog/
• Support: https://branchpy.com/contact

Licensing

BranchPy offers a free tier for Ren'Py projects.

Some advanced features may require activation through the BranchPy website.

See https://branchpy.com for details.