Aller au contenu

Démarrer avec Forge

De zéro à une application qui tourne, en trois étapes.
Chaque commande est en copier-coller ; les détails complets sont reliés au fil du texte.

1. Installer Forge

Choisissez l'onglet correspondant à votre poste.
La commande d'installation est la même partout (pipx) ; seule la préparation système change, détaillée dans chaque parcours complet.

Prérequis : Python 3.12+ et pipx.

pipx install --pip-args="--pre" forge-mvc
forge --version

Parcours complet : Poste Linux (pipx).

Forge s'utilise sous WSL2 (Ubuntu), pas en Windows natif.

# dans le terminal Ubuntu (WSL2)
pipx install --pip-args="--pre" forge-mvc
forge --version

Résumé : Installation Windows.
Pas-à-pas complet : Windows + WSL.

Après installation des paquets système (Python 3.12, pipx) :

pipx install --pip-args="--pre" forge-mvc
forge --version

Parcours complet : VM Debian vierge.

Pour contribuer au framework ou figer une version précise :

git clone https://github.com/caucrogeGit/Forge.git
cd Forge
python -m pip install -e .
python -m pip install -r requirements.txt

Détails : Installation depuis GitHub.

Toutes les options

Comptes MariaDB, opt-ins, configuration VS Code : voir la page Installation.

2. Créer le projet

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 HTTPS de développement.

Deux étapes manuelles avant la base de données

Renseignez les identifiants MariaDB dans env/dev, puis lancez forge db:init.
Les premiers paliers tournent sans base de données ; pour choisir un moteur (SQLite sans serveur, MariaDB en production), voir Bases de données.

3. Lancer

forge run

Forge démarre en HTTPS sur https://localhost:8000 et redémarre automatiquement dès que vous modifiez un fichier de l'application (autoreload).

En production

forge run refuse de servir en production.
Le seul chemin supporté est WSGI + Gunicorn derrière un reverse proxy : Déploiement WSGI.

Toutes les commandes

Diagnostic, génération, migrations, CRUD : voir la Référence CLI.

Et après ?