Documentation BranchPy

Version de la documentation : v1.1.23 pré-version. Télécharger BranchPy · Notes de version

BranchPy aide les créateurs Ren'Py et les équipes techniques à analyser leurs projets narratifs, détecter les problèmes de flux et d'assets, et itérer en toute confiance.

Ce que vous obtenez en une seule exécution

branchpy --project my-game analyze --open

Analyze complete
- labels detected: 742
- warnings found: 14
- errors found: 3
- flow outputs available: yes

Then open:
- Flowchart: visual story structure and dead ends
- Media Validation: missing and unreferenced assets
- Stats: project and narrative metrics

Durées d'exécution typiques (machine locale, approximatif) :

• Petit VN (<200 labels) : 2–5 secondes
• VN moyen (200–1 000 labels) : 10–30 secondes
• Grand VN (>1 000 labels) : 30–120 secondes

Sécurité et confiance :

• S'exécute en local.
• Ne modifie pas vos fichiers de projet pendant l'analyse.
• Chemin d'analyse déterministe pour des exécutions locales/CI reproductibles.
• Les fonctionnalités IA sont optionnelles.

Chemin recommandé :

• Démarrez dans VS Code avec le Control Center BranchPy pour une prise en main rapide.
• Utilisez le CLI pour l'automatisation, CI, et les exécutions scriptées déterministes.

Par où commencer

• Téléchargement et installation — Chemins d'installation VS Code et CLI.
• Démarrage rapide en 3 minutes — Installer, exécuter, corriger un problème, et lire votre premier résultat de flux.
• Les 10 premières minutes avec BranchPy — Compléter la boucle principale : Analyze, Flowchart, Doctor, Media Validation, Compare.
• Comment BranchPy fonctionne — Modèle mental en une page du pipeline d'analyse.
• Première exécution : VS Code + CLI par fonctionnalité — Une fonctionnalité, deux modes d'exécution.
• Compte et licence — Se connecter et activer Ren'Py Free.
• Accueil du guide utilisateur — Workflows pratiques.

Obtenir de l'aide

• Signaler un bug
• Poser une question
• Demander une fonctionnalité
• Hub Communauté

Fonctionnalités principales

• Analyze
• Stats
• Compare
• Media Validation
• Flowchart
• Flowchart+
• Governance
• Patch Timeline
• Settings

Fonctionnalités avancées

• Pilot — Analyse des variables axée sur les chemins (nécessite Analyze)
• Omega — Bornes de variables et signaux de co-occurrence (nécessite Pilot)
• Function Manager — Découvrir, indexer et inspecter les fonctions personnalisées

CLI et automatisation

• Vue d'ensemble CLI
• Référence CLI
• Référence rapide CLI
• Modes d'exécution par fonctionnalité (VS Code + CLI)

Avancé et référence

• Accueil de la documentation technique
• Internals d'analyse
• Déploiement
• Auth, licences, SSO
• Télémétrie

Soutenir BranchPy

Si BranchPy vous fait gagner du temps, vous pouvez soutenir le développement ici :

• Buy Me a Coffee

Version de la documentation : 1.1.1
Dernière mise à jour : mars 2026