Aller au contenu

Démarrer avec Forge

Accueil Retour

Cette page est le point d'entrée pour un développeur qui découvre Forge. Deux étapes : installer Forge, puis créer un premier projet.

Étape 1 — Installer Forge

Choisissez le chemin adapté à votre contexte :

Contexte Documentation
Machine ou VM Debian vierge Installation VM Debian
Outil CLI isolé (recommandé) Installation avec pipx
Version spécifique depuis un tag Installation depuis GitHub
Préparer la base de données MariaDB Préparer MariaDB
Contribuer au framework Forge Mode développement
Développeur Windows 11 (via WSL2) Installation Windows

Vue d'ensemble des packages et méthodes : installation.md.

Forge se lance de trois façons équivalentes :

forge --version              # après pip install (recommandé)
python -m forge --version    # module Python
python forge.py --version    # script direct (développement)

Étape 2 — Créer un premier projet

Une fois Forge disponible dans votre environnement :

forge new MonProjet
cd MonProjet
source .venv/bin/activate

forge new crée le projet, installe les dépendances et génère les certificats SSL. Il reste deux étapes manuelles : renseigner les mots de passe MariaDB dans env/dev, puis lancer forge db:init.

Étape 3 — Continuer

Pour la liste complète des commandes disponibles : Référence CLI.

Le Guide de démarrage couvre les étapes suivantes : configurer MariaDB, créer une entité, générer le CRUD et lancer l'application.

Pour aller plus vite, essayez les tutoriels guidés :