Installation¶

Accueil Retour

Forge peut s'installer de plusieurs façons selon votre contexte. Choisissez le chemin le plus simple pour votre usage, puis passez au guide de démarrage.

Chemins recommandés¶

Usage	Méthode
Préparer une machine complète	Installation sur une VM Debian vierge
Utiliser Forge comme outil installé	Installation avec pipx
Créer un projet depuis une version stable	Installation depuis GitHub
Contribuer au framework Forge	Mode développement
Préparer la base locale	Préparer MariaDB

Modèle de packages¶

Forge 1.0.0b8 distribue le core sur PyPI sous forge-mvc==1.0.0b8 (bêta publique — --pre requis). Les 4 modules opt-in restent en mode source-only via GitHub. Voir Politique de release.

Package (monorepo)	Contenu	Statut
`forge-mvc`	Noyau complet — core, CLI, intégrations	Bêta
`forge-mvc-mfa`	Brique MFA — TOTP, codes de récupération	Alpha — non publié PyPI en `1.0.0b8`
`forge-mvc-rbac`	Brique RBAC — contrôle d'accès par rôles	Beta
`forge-mvc-workflow`	Brique workflow — statuts et transitions	Beta
`forge-mvc-stats`	Brique statistiques — agrégations	Beta

Pour installer Forge avec toutes les briques opt-in :

git clone --branch v1.0.0-beta.8 https://github.com/caucrogeGit/Forge.git
cd Forge
python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e .
python -m pip install -r requirements-dev.txt

pip install -e . installe le core en mode éditable. requirements-dev.txt installe ensuite les 4 modules opt-in (également en éditable) et les outils de développement. Voir Installation depuis GitHub pour les détails.

Contrat d'installation des opt-ins¶

À partir de 1.0.0-beta.5, le core forge-mvc et les opt-ins publiables forge-mvc-rbac, forge-mvc-workflow et forge-mvc-stats sont publiés sur PyPI.

Les extras forge-mvc[rbac], forge-mvc[workflow], forge-mvc[stats] et forge-mvc[all] sont disponibles :

pip install --pre "forge-mvc[rbac]"
pip install --pre "forge-mvc[workflow]"
pip install --pre "forge-mvc[stats]"
pip install --pre "forge-mvc[all]"

forge-mvc[media] et forge-mvc[mfa] ne sont pas disponibles :

forge-mvc-media : source-only après extraction Phase 11.
forge-mvc-mfa : Alpha — secret TOTP chiffré au repos (Fernet). Non publié sur PyPI en 1.0.0b8 — publication prévue lors d'une release dédiée.

Pour installer les opt-ins en 1.0.0b8, utiliser le mode source :

git clone --branch v1.0.0-beta.8 https://github.com/caucrogeGit/Forge.git
cd Forge
python -m venv .venv
source .venv/bin/activate
python -m pip install -e .
python -m pip install -r requirements-dev.txt

requirements-dev.txt installe les 4 modules opt-in en mode éditable.

Version stable¶

Forge 1.0.0b8 utilise la référence stable v1.0.0-beta.8 par défaut.

forge --version
forge new MonProjet

Pour travailler explicitement depuis la branche de développement :

forge new MonProjet --ref main

Après installation¶

Une fois Forge disponible :

cd MonProjet
source .venv/bin/activate
forge doctor

Le guide suivant couvre la création d'une première entité et d'un CRUD complet.