BranchPy — Ren’Py Visual Novel Analysis Tool

Stable release access is available now.

BranchPy analyzes your Ren’Py project to:

• visualize branching paths (flowchart)
• detect unreachable or inconsistent logic
• validate assets and media
• measure narrative complexity

BranchPy v1.2.3 is out.

Improved Flowchart+ and Media Validation classification.

Start using BranchPy immediately

You can install and explore BranchPy without an account.

To unlock full analysis features (Analyze, Stats, Flowchart, ...),
create a free account and activate your Ren’Py license.

⏱ Setup takes ~5 minutes

Installation

1. Install the CLI: `pip install branchpy-cli`

2. Optional but recommended: install the **BranchPy** VS Code addon from the Visual Studio Code Marketplace

Note: the VS Code addon requires the CLI and does not work as a standalone tool.

Free for individual Ren’Py developers

No trial. No paywall.

***

🚀 BranchPy analyzes your project and turns it into a clear, visual map.

BranchPy is a developer tool that analyzes your Ren’Py visual novel and reveals its structure, issues, and hidden complexity.

[Full branching flowchart generated automatically — see your entire story at a glance]

[Validate your labels, variables, and logic — catch issues before they break your game]

🧠 Why it exists

Ren’Py projects grow fast — and become hard to understand.

• Where are the dead ends?
• Which paths are unreachable?
• Which images or files are never used?
• How complex is your story structure?

BranchPy gives you a clear, visual answer.

[Compare story paths side-by-side — understand how choices diverge and where they lead]

🔍 What BranchPy analyzes

• Story flow (full branching structure)
• Dead ends and unreachable paths
• Missing or unused assets (images, media)
• Structural inconsistencies
• Project complexity and density

[Detect image quality issues and get actionable recommendations to optimize your assets]

📊 What you get

• Interactive flowcharts
• Analysis reports (HTML)
• Clear identification of issues and risks
• A “map” of your story logic

[Detect missing, unused, and redundant assets — keep your project clean and optimized]

The tool is fully usable today (pre-release). Feedback welcome.

🤝 Interested?

🔥 Get Access & Follow Development

• 💬 Discord → Get access, ask questions, share feedback
  👉 https://discord.gg/dSQNQCSv

• 🌍 Website → Docs, registration, download, features, and roadmap
  👉 https://branchpy.com