v1.1.25 · Pre-release
Télécharger BranchPy (Pre-release)
BranchPy est gratuit pour les développeurs Ren'Py indépendants. Aucun paiement, aucun dossier requis.
Téléchargez le paquet ci-dessous et suivez les instructions d'installation.
⏱ Visualisez votre histoire en moins de 2 minutes — aucun setup, tout fonctionne en local.
Note de confiance : la télémétrie est désactivée par défaut, le code source et les chemins de fichiers ne sont jamais transmis, et les utilisateurs Ren'Py bénéficient d'un accès gratuit à toutes les commandes pendant la période de pre-release.
Avant de commencer
- Vous pouvez installer et explorer BranchPy sans compte
- Les fonctionnalités d'analyse complètes nécessitent un compte gratuit
- La configuration prend environ 5 minutes
Ce que vous verrez
Après le premier lancement, vous verrez immédiatement la structure complète de votre histoire, les branches inaccessibles et les problèmes logiques détaillés.
Analyze : erreurs, avertissements, flux narratif
Flowchart : carte interactive de votre histoire
Omega : compréhension structurelle approfondie
Installer en 2 minutes
Sur toutes les plateformes, la méthode recommandée est pip install branchpy-cli. Sur Windows, un installateur alternatif est aussi disponible ci-dessus. Suivez les instructions ci-dessous selon votre configuration.
⬇️ Alternative · Windows
Windows — installateur alternatif
Téléchargez l'installateur — il configure automatiquement le CLI BranchPy. Si VS Code est détecté sur votre machine, l'extension est installée en même temps.
- Téléchargez branchpy-setup-1.1.25.exe depuis la section ci-dessus.
- Double-cliquez pour lancer l'installateur. Python est installé automatiquement s'il est absent.
- Si VS Code est détecté, l'extension est installée automatiquement. Sinon, installez le .vsix manuellement après (voir le lien de téléchargement ci-dessus).
- Ouvrez VS Code, ouvrez le BranchPy Control Center dans la barre latérale, et lancez Analyze.
Mise à jour ? Relancez l'installateur — il remplace automatiquement la version précédente.
✅ Signé numériquement — BranchPy inc.
L'installateur est signé via Microsoft Artifact Signing. Windows affichera BranchPy inc. comme éditeur vérifié.
Remarque : Windows peut quand même afficher un avertissement pour les nouvelles applications — c'est normal. Si vous le voyez, cliquez sur Informations complémentaires puis sur Exécuter quand même.
🚀 Recommandé · toutes plateformes
macOS / Linux / Windows — installation directe
Installez le CLI depuis PyPI, puis installez l'extension VS Code via le .vsix.
pip install branchpy-cli
code --install-extension branchpy-vscode-1.1.25.vsix
- Installez Python 3.11+ si nécessaire.
- Dans un terminal, exécutez
pip install branchpy-cli pour installer le CLI.
- Téléchargez le .vsix depuis la section ci-dessus et exécutez
code --install-extension branchpy-vscode-1.1.25.vsix.
- Lancez votre première analyse : python3 -m branchpy --project chemin/vers/projet analyze
- Ajoutez --open pour ouvrir le Flowchart, la validation Média ou les rapports dans votre navigateur.
Vous pouvez aussi installer depuis le fichier .whl téléchargé si vous préférez éviter PyPI. Le Flowchart en mode CLI/navigateur est un visualiseur interactif. FlowchartPlus dans VS Code reste le flux de travail le plus complet.
👉 Étape suivante :
Ouvrez VS Code, cliquez sur l'icône BranchPy dans la barre latérale, sélectionnez votre projet et cliquez sur Analyze. Votre première carte d'histoire s'ouvre en quelques secondes.
Voir le guide complet →
Like BranchPy? If it helps your workflow, you can support development directly without scrolling to the end of this page.
Démarrer rapidement
Une fois installé, suivez ces étapes pour créer votre compte, connecter l'outil et lancer votre première analyse.
Lire la documentation complète →
Avant de commencer : l'installation est couverte dans la section ci-dessus. BranchPy fonctionne mieux lorsque votre projet Ren'Py utilise une structure standard : un dossier game/ contenant des fichiers .rpy. Utilisez le sélecteur de projet dans BranchPy Control Center — ne supposez pas que le dossier VS Code actif est déjà la bonne cible.
VS Code workflow
- Create an account at branchpy.com/register. Free, no payment required.
- Débloquez toutes les fonctionnalités: dans votre compte, allez dans Profile → License et cliquez sur Claim Ren'Py Free.
- Sign in via SSO: in VS Code, the BranchPy Control Center (BPy CC) will show a sign-in prompt. Click it — it opens a browser tab where you authenticate with your BranchPy account.
- Approve your device: on first sign-in, a device approval link is sent to your email. Click it to authorise this machine. You only do this once per device.
- Select your project: in the BPy CC sidebar, choose your Ren'Py project from the detected project list. If it doesn't appear, use the folder picker.
- Run Analyze — click the Analyze button. The report opens in the panel with errors, warnings, and insights.
- Then explore: click Flowchart for the interactive story graph, Stats for narrative metrics, Media Validation for asset checks. Each opens its own panel — you can have multiple open at once.
CLI workflow
- Create an account at branchpy.com/register.
- Débloquez toutes les fonctionnalités: dans votre compte, allez dans Profile → License et cliquez sur Claim Ren'Py Free.
- Sign in via SSO: run
branchpy login — this opens a browser tab where you authenticate.
- Approve your device via the link sent to your email. One-time step per machine.
- Store your project path so you don't retype it on every command:
# PowerShell
$P = "C:\path\to\my-game"
# Bash / Zsh
P="/path/to/my-game"
- Run your first analyses:
branchpy --project "$P" analyze --open
branchpy --project "$P" stats --open
branchpy --project "$P" media --open
branchpy --project "$P" flowchart --open
- Useful options on any command:
--open — opens the result in your browser automatically--html — saves an HTML report to disk--json — outputs machine-readable JSON--save-report — saves the report alongside the project
Compte, licence et questions de premier démarrage
Ai-je besoin d'un compte ?
Vous pouvez lancer votre première analyse sans compte. Créez un compte gratuit sur
branchpy.com/register pour débloquer toutes les fonctionnalités d'analyse.
Is BranchPy free?
Yes — free for individual Ren'Py developers. No payment, no time limit. A small contribution is asked for commercial games only, on a trust basis — no audits.
What is Ren'Py Free?
Free access for Ren'Py developers — unlocks all commands. Free for personal projects, small contribution for commercial games — on a trust basis, no audits.
What happens after pre-release?
Most features remain free for personal Ren'Py projects. A small contribution will be asked for commercial games only — on a trust basis, we don't check your work. Optional AI features may require a Pro plan.
How to unlock full features: create a free account on BranchPy, open Profile → License, then click Claim Ren'Py Free.
CLI account and license commands: use the branchpy license command family, such as branchpy license login, branchpy license status, and branchpy license claim-renpy.
État de développement actuel
Stable features
Analyze, Stats, Compare, Media Validation, Flowchart, FlowchartPlus, Control Center, Pilot.
Early access features
Omega, PFI, Compare Lanes, Patch Timeline, Governance.
Known issues
Some edge cases may still appear in large or unusual projects. Bug reports help improve the tool quickly.
Dépannage avant de signaler un bogue
- Opened the wrong folder? Open the Ren'Py project root, not a parent folder above it.
- VS Code visuals missing? Some visual surfaces can open in the browser when native VS Code support is not present.
- Need to check what BranchPy collected? Telemetry is disabled by default and reviewable before anything is sent.
Aider à améliorer BranchPy
Early users are part of the product loop. Report bugs, suggest features, join the community, or support development with a coffee.
