Installer cybertrain

01Prérequis

• Spinel 2026.10.27.7020 (Cybertrain::SPINEL_TAG, la même version que SPINEL_TAG dans .github/workflows/ci.yml), une version de saeki-mototsune/spinel (Cybertrain::SPINEL_REPOSITORY), le fork de matz/spinel qui intègre les corrections dont CyberTrain a besoin avant une version amont ; non testé avec d’autres versions. Vous ne l’installez pas à la main : la commande cybertrain compile cette version dans ~/.cybertrain la première fois qu’elle en a besoin (cybertrain setup le fait à la demande), sauf si un spinel de cette version est déjà dans le PATH — voir Comment Spinel est installé.
• Pour le compiler : une chaîne de compilation C (cc, ou le compilateur désigné par CC) et make — Spinel compile chaque programme en C —, plus git et curl.
• En-têtes et bibliothèque SQLite 3 (libsqlite3-dev sous Debian/Ubuntu ; fournis avec les Command Line Tools de Xcode sous macOS) — les modèles utilisent directement la FFI de Spinel, pas une gem.
• En-têtes et bibliothèque zlib (zlib1g-dev sous Debian/Ubuntu ; dans le SDK de macOS) — les corps de requête gzip (request.decoded_body) sont décompressés par la zlib du système, liée de la même façon.
• Ruby 3.2+ et RubyGems, uniquement pour la commande cybertrain (les applications ne tournent jamais sur CRuby) ; avec Ruby 3.2, la compilation de Spinel demande aussi la gem prism (ci-dessous).

cybertrain doctor vérifie ces outils et en-têtes ainsi que l’installation de Spinel ; quand un élément requis manque, il affiche aussi la commande d’installation pour votre plateforme.

02Installer la CLI

gem install cybertrain
cybertrain doctor

La première ligne installe la commande depuis RubyGems et la seconde vérifie les prérequis ; le tutoriel continue à partir de là, de cybertrain new à cybertrain build.

03La commande cybertrain

cybertrain help affiche ces commandes :

• cybertrain new NAME [--path DIR | --version V | --git URL [--ref R]] [--skip-spin] crée une application dans NAME, puis y lance spin lock et spin run gen, en installant d’abord Spinel si nécessaire.
• cybertrain generate scaffold NAME field:type ... (alias g scaffold) ajoute une ressource à l’application du répertoire courant.
• cybertrain generate authentication y ajoute la connexion par adresse e-mail et mot de passe : les tables users et sessions, les modèles User et Session, les contrôleurs et vues de connexion et d’inscription, les routes, un before_action dans ApplicationController et un test (voir Ajouter la connexion). Avec --invite-only, il n’y a pas de page d’inscription : les utilisateurs sont créés avec ./NAME user EMAIL, et le premier aussi sur une page /setup qui ne répond qu’à la machine du serveur elle-même, avec le jeton à usage unique qu’affiche son avertissement de démarrage, tant qu’aucun utilisateur n’existe.
• cybertrain generate attachment MODEL FIELD [--any] ajoute l’envoi d’un fichier à un modèle généré par scaffold : cinq colonnes de métadonnées, des méthodes et callbacks de modèle, une action de téléchargement, la route, le champ de formulaire et un test (voir Ajouter une image de couverture). Un champ de scaffold cover:attachment fait la même chose.
• cybertrain db migrate génère, applique les migrations en attente, puis génère à nouveau (spin run gen; spin run db -- migrate; spin run gen) ; cybertrain migration est conservé comme alias.
• cybertrain db COMMAND... lance toute autre commande de base de données après spin run gen : status, rollback [N] (qui génère à nouveau ensuite), schema:dump, create.
• cybertrain server [PORT] génère, puis démarre le serveur de développement (spin run gen; spin run NAME, ou spin run NAME -- PORT ; port 3000 par défaut).
• cybertrain build compile NAME avec app/views/ intégré et assemble dist/ (le binaire, public/, storage/, tmp/).
• cybertrain spin ARGS... lance spin avec le Spinel épinglé, depuis n’importe quel répertoire (cybertrain spin test, cybertrain spin run gen -- --check).
• cybertrain setup [--force] installe Spinel 2026.10.27.7020 dans ~/.cybertrain, sauf si un spinel de cette version est déjà dans le PATH ; --force recompile la copie sous ~/.cybertrain.
• cybertrain doctor vérifie la chaîne de compilation C, les en-têtes SQLite et l’installation de Spinel.
• cybertrain version affiche la version.

db, server et build s’exécutent dans une application ; NAME est le [package] name de son spin.toml.

04Comment Spinel est installé

Chaque commande qui lance spin (new, db, server, build, spin) s’assure d’abord qu’un Spinel de la version de Cybertrain::SPINEL_TAG est disponible. Un spinel du PATH (accompagné d’un spin) dont spinel --version indique cette version est utilisé tel quel ; sinon, la copie que cybertrain conserve sous ~/.cybertrain/spinel/2026.10.27.7020/ est utilisée ; sinon, cybertrain compile cette copie à partir du tag de version de Cybertrain::SPINEL_REPOSITORY (git clone, make deps, make -j, make install PREFIX=...), une seule fois, en quelques minutes. Le journal de compilation est ~/.cybertrain/log/spinel-2026.10.27.7020-build.log (ses dernières lignes sont affichées si une étape échoue).

S’il manque un outil nécessaire à la compilation, cybertrain indique lequel et affiche la commande d’installation pour votre plateforme avant de commencer. Un spinel d’une autre version présent dans le PATH n’est jamais utilisé ni modifié : cybertrain conserve sa propre copie (et le signale quand il l’installe).

cybertrain setup fait la même chose à la demande et, chaque fois que c’est sa propre copie qui est utilisée, affiche la ligne qui la place dans le PATH, pour lancer spin vous-même :

export PATH="$HOME/.cybertrain/bin:$PATH"

~/.cybertrain/bin contient des liens spinel et spin vers la version utilisée, la ligne reste donc valable après un changement de version ; cybertrain spin ... n’a besoin d’aucun PATH.