Qu'est-ce qui est quoi
Cradle Studio, cradle-server et le CLI cradle — trois parties du système, où chacune s'installe, et ce qu'il ne faut pas installer du tout.
Avant d'installer quoi que ce soit, il faut distinguer trois choses. Les noms se ressemblent, mais les rôles diffèrent — et elles vont sur des machines différentes.
Les trois composants
| Ce que c'est | Où ça vit | Installé depuis | |
|---|---|---|---|
cradle-server | Le daemon. Détient la base SQLite, les modèles, le RAG et les canaux (Telegram, widget, API HTTP). Le seul composant qui travaille réellement | sur le serveur | le paquet cradle-cli |
cradle | Un client HTTP léger. Pas de base, pas de modèles — chaque commande est un appel vers l'espace /admin/* d'un serveur | partout : sur le serveur comme sur votre portable | le même paquet cradle-cli |
| Cradle Studio | L'application de bureau (Electron + React). Même moteur à l'intérieur, mais embarqué — avec sa propre base locale et ses modèles | sur votre poste de travail | un installateur DMG / EXE distinct |
Le paquet s'appelle cradle-cli, mais il livre les deux binaires — le daemon
et le client. Le nom est historique : il vient du préfixe dans le bucket de
téléchargements.
Pourquoi le CLI se retrouve aussi sur le serveur
cradle n'est pas « la moitié bureau ». C'est l'outil pour piloter un serveur
depuis n'importe où : sur le serveur lui-même il parle à localhost:31416,
depuis un portable à http://<adresse-serveur>:31416. Les commandes sont
identiques.
C'est aussi ainsi que se fait le déploiement : cradle server init n'est pas du
travail sur les données mais une commande d'opérateur qui crée la base, la
première clé API et l'unité systemd. D'où la présence du CLI sur le serveur dès
le début.
Ce qui n'est pas lié
L'application de bureau et le serveur ne font pas partie d'une même installation. Ce sont deux façons indépendantes de lancer le même moteur :
- Portable seul, travail en local → installez Cradle Studio.
Aucun serveur à déployer : l'application démarre elle-même un
cradle-serverembarqué. - Serveur partagé, modèles lourds, plusieurs personnes →
déployez
cradle-serveret connectez-vous depuis Studio ou le CLI. Le DMG n'a pas sa place sur le serveur.
La séquence habituelle
- Sur le serveur (une fois) — l'installateur met en place
cradle-serveretcradle, crée la base et émet la première clé admin. - Démarrer le daemon — via systemd (avec root) ou à la main avec
cradle-server. - Connecter un client — au choix :
cradle login --url http://<adresse-serveur>:31416 --key ck_live_..., puiscradle agents,cradle models pull,cradle health;- ou Cradle Studio si vous préférez une interface graphique.
L'étape 3 fonctionne pareil depuis le serveur et depuis un portable — une seule
commande, un --url différent.
Qu'est-ce que Cradle ?
Cradle est un système de harnais pour LLM locaux — une couche d'orchestration et de contrôle avec un filtrage de risque à deux niveaux et une validation humaine, et pas seulement un agent.
Installer l'application de bureau
Téléchargez et installez Cradle, le client de bureau, sur macOS, Windows ou Linux.