démarrersans clé api · sans compte

Comment demander à votre agent d'installer l'atelier Mojulo.

Vous n'installez pas mojulo vous-même. Vous collez une seule consigne dans l'agent de code que vous utilisez déjà — Claude Code, Codex, tout agent compatible MCP — et c'est lui qui fait l'installation, en demandant avant chaque étape. Puis vous lui demandez une petite chose. Ce qui revient est conservé sous forme de recette — un petit fichier qui la refait à l'identique, et qui survit à la conversation. Sans clé API, sans compte, sans télémétrie ; ce que vous fabriquez reste sur votre machine.

npx mojulo init
prérequis·node 22.12+·apache‑2.0·tourne en local·sans compte

quatre étapesinstaller · s'orienter · frapper · modifier

1

Collez ceci dans votre agent

N'installez rien vous-même — confiez la tâche à l'agent que vous utilisez déjà. Ouvrez Claude Code ou Codex et collez cette consigne. Il vérifie d'abord la machine, rapporte ce qu'il a trouvé et demande votre permission avant d'installer quoi que ce soit — rien n'entre sur votre machine sans un oui.

Aide-moi à installer mojulo — une usine 3D locale et gratuite, que tu piloteras via MCP.
Repères, si tu peux les récupérer : https://mojulo.ai/llms.txt
(miroir si le site est hors ligne : https://github.com/zombico/mojulo)

1. Commence par vérifier : lance `node --version`. Mojulo exige Node 22.12+.
   Dis-moi ce que tu as trouvé avant de changer quoi que ce soit.
2. Si Node est absent ou trop ancien, demande-moi la permission, puis installe-le
   comme cette machine l'attend (brew / winget / nvm / apt).
3. Avec mon accord, lance `npx mojulo init`. Cela câble mojulo dans les agents
   de code de cette machine (un oui/non par hôte) et ouvre un tableau de bord
   sur localhost:3001. Tout reste sur ma machine.
4. Quand c'est terminé, dis-moi d'ouvrir une nouvelle session et de te demander :
   « qu'est-ce que c'est ? »

N'installe jamais quoi que ce soit sans me le demander d'abord.

Ce qui descend : le paquet et son runtime natif — environ 985 Mo sur disque, mesurés sur une machine — et, au premier lancement, un modèle de recherche d'environ 130 Mo. Les bibliothèques de rendu 3D font partie de l'installation par défaut. La seule chose qui n'en fait pas partie est le navigateur headless avec lequel l'usine cuit les images fixes : il est récupéré la première fois qu'une cuisson en a besoin (environ un demi-gigaoctet), jamais à l'installation, et un Chrome, Chromium, Edge ou Brave déjà présent sur la machine est utilisé à la place. Les chiffres mesurés, et tout ce dont la machine a besoin par ailleurs, sont dans les prérequis techniques ci-dessous.

Vous préférez le piloter vous-même ? Installez Node.js 22.12+ depuis nodejs.org et lancez npx mojulo init. Dans les deux cas, tout tourne sur votre machine — le tableau de bord s'ouvre sur localhost:3001 (ou le prochain port libre ; l'installateur affiche l'URL) et l'état se pose dans ~/.mojulo/. Sans compte, sans identifiant à remettre ; relancer init répare un ancien câblage au lieu de le dupliquer. La même installation sert aussi de ligne de commande — npx mojulo tools liste ce qu'il y a dedans, npx mojulo call <tool> exécute n'importe quoi, sans agent dans la boucle.

2

Demandez à votre agent ce qu'il a sous les yeux

Ouvrez une nouvelle session d'agent — le nouveau câblage est pris en compte au démarrage — et tapez une ligne. Mojulo lit son propre index de routage et s'oriente à voix haute — sans clé de fournisseur, sans appel au nuage, rien de construit encore.

qu'est-ce que c'est ?

forward_context — l'usine qui s'explique elle-même. C'est l'interface prévue : vous demandez, votre agent découvre le bon outil et s'en saisit.

3

Demandez une petite chose

Demandez ensuite quelque chose qui est à vous. Votre agent le rédige, mojulo le conserve en petite recette déterministe et vous tend une URL à ouvrir.

modélise un mug à café en centimètres réels que je puisse orbiter   → mint_solid

la recette est l'artefact conservé — quelques lignes lisibles qui refont pousser la même tasse à chaque ouverture. le rendu en est dérivé et jetable ; la recette reste sur votre disque pour la reprendre la semaine prochaine.

Si un outil 3D refuse un jour et nomme mojulo install creative, lancez-le. Les bibliothèques de rendu sont livrées dans l'installation par défaut, mais un npm install --omit=optional ou une compilation native échouée peut les laisser de côté — et le refus le dit au lieu d'échouer en silence.

4

Puis modifiez-la

« Rends-la plus haute. » « Change la teinte. » Votre agent modifie quelques lignes de la même recette sur place et elle est rendue à nouveau ; rien n'est régénéré depuis une boîte noire, et les lignes qu'il a changées sont là, à lire.

épaissis l'anse et passe l'émail en noir mat   → update_sketch

Une tasse est le plancher, pas le plafond. Ce que l'usine fabrique d'autre — et où une chose finie peut aller ensuite — l'atelier le nomme quand vous avez quelque chose en main, ou quand vous le demandez. Cette page cesse de promettre ici, volontairement.

le premier voldemander → frapper → regarder → garder

Voici comment un objet réel a vraiment été fait, y compris le moment où la première tentative était fausse. La correction n'est pas un échec de la méthode ; elle est la méthode.

vous
modélise une lanterne tempête à l'échelle réelle que je puisse orbiter en 3D
agent
frappe en cours — sept profils tournés empilés et une poignée balayée : laiton, cuivre, verre, 40 cm de haut. Ouvre /sketches/sk_jon77cn4ud et orbite-la.
vous
la poignée flotte
agent
en effet — les extrémités de l'anneau sont à ±6,5 cm au-dessus d'un collier de 3,6 cm. Je repositionne le balayage… v2 frappée. L'anneau se pose sur le collier.
vous
garde-la

mint_solid — la demande est en langage courant, une chose et une échelle. personne n'a tapé de coordonnée : les pièces sont placées par relations déclarées (sur / écart / radial), et l'usine les résout.

ce qui est conservé, c'est la recette — 1,8 Ko de profils et un tracé. la lanterne que vous faites tourner en est dérivée à chaque rendu, et le rendu est jetable.

« la poignée flotte », c'est la porte des yeux — quelqu'un regarde vraiment avant qu'une chose soit gardée. la recette a rendu le raté bon marché : un tracé modifié, v2 frappée, et les deux versions persistent en recettes que vous pouvez comparer.

et après « garde-la », les portes — une chose gardée peut sortir : un fichier pour une imprimante, une page que vous pouvez héberger, des pièces plus grandes que ça. personne ne les liste d'avance ; l'atelier nomme les portes qui conviennent à la chose que vous tenez, au moment où vous la tenez. les portes ouvrent sur des outils que vous utilisez déjà — blender, un moteur de jeu, un slicer — sous forme de fichiers qu'ils lisent déjà, et ce que vous y affinez peut revenir se lier à la même recette.

prérequis techniquesce qu'il faut · ce que ça pèse · ce qui est optionnel

La version courte de ce que mojulo demande à une machine. Chaque chiffre a été mesuré sur une machine à une date indiquée ; la fiche complète, jusqu'à la taille de chaque dépendance, est dans le dépôt.

pour tourner

Node.js 22.12 ou plus récent. Le seul plancher strict ; un Node plus ancien s'arrête avec un message au lieu de fonctionner à moitié.

Un hôte MCP. Claude Code ou Codex en tirent le plus ; Claude Desktop et les autres hôtes se câblent par profil déclaré.

Un OS de bureau. Construit et vérifié sur macOS, Apple Silicon. Linux : la suite de tests tourne sous Ubuntu en CI, et une installation à froid de 2.0.1 a été vérifiée sur Linux x64 et arm64 ; les vérifications de moteurs plus bas n'y sont pas vérifiées. Windows : vérifié sur une machine Windows native avec Claude Code — npx mojulo init est allé au bout et un premier rendu est arrivé ; Codex là-bas, et les vérifications de moteurs plus bas, ne l'ont pas été.

Pas de GPU, pas de clé de fournisseur, pas de compte. Les images fixes cuisent sur le CPU. Votre agent est la boucle de raisonnement ; une clé n'entre en jeu que lorsque quelque chose doit peindre.

sur disque

Tarball de 36 Mo, ~985 Mo sur disque après npx mojulo init — mesurés le 2026-09-11 sur mojulo 2.0.2, macOS arm64. Les bibliothèques de rendu 3D sont comprises dans ce chiffre ; npm install --omit=optional les retire (~86 Mo) et mojulo install creative les remet.

~130 Mo de modèle de recherche, récupéré une seule fois au premier lancement dans ~/.mojulo/models/.

Des kilooctets par recette. Tout ce que vous fabriquez tient dans un fichier SQLite sous ~/.mojulo/data/.

récupéré plus tard, seulement si nécessaire

~500 Mo de Chrome headless, la première fois qu'une cuisson en a besoin — ignoré si Chrome, Chromium, Edge ou Brave est déjà sur la machine.

~19 Mo de ffmpeg, la première fois que des clips sont assemblés en MP4 — ignoré si ffmpeg est déjà dans votre PATH.

Rien ne se télécharge à l'installation. Ces deux-là se mettent en cache dans le répertoire du paquet plutôt que dans ~/.mojulo/ ; la fiche complète nomme les variables qui les déplacent.

optionnel · vous installez, mojulo détecte

Godot 4.5 ou plus récent (gratuit) ouvre un pack de jeu comme projet. Blender 4.x ou plus récent (gratuit) prend la passe artistique et la cuisson. Unity 6, activé, avec le paquet glTFast du Package Manager. Unreal 5.4 ou plus récent ; un pack de jeu compile du C++, donc Xcode sur macOS ou Visual Studio sur Windows.

Un slicer — PrusaSlicer ou Bambu Studio — estampille une vérification d'impression headless à côté du STL ou du 3MF ; n'importe quel slicer ouvre le fichier.

Chaque export fonctionne sans aucun d'eux : le pack et son guide d'import pas à pas sont écrits dans tous les cas, et la vérification machine signale « skipped » avec la raison. Les moteurs sont des installations de plusieurs gigaoctets sous leurs propres licences ; mojulo n'en télécharge ni n'en configure jamais un.

ouvriers optionnels

Des installations séparées que vous faites tourner vous-même ; mojulo ne les démarre jamais et n'en dépend pas, et leur absence éteint une boucle sans rien casser. ComfyUI avec Qwen-Image-Edit peint quand votre agent ne le peut pas — ~31 Go, ou un quant de ~17 Go sur Apple Silicon. Kokoro dit la narration — ~92 Mo. TripoSR sculpte le détail de surface sur le greybox — ~1,4 Go.

réseau

Pas de télémétrie. Le trafic sortant n'a lieu que sur des actions explicites : npm qui récupère le paquet, les téléchargements uniques ci-dessus, check_for_updates quand votre agent l'appelle, et ce que fait le fournisseur de votre agent — ce trafic est celui de l'agent, pas celui de mojulo.

pour retirer

Décâblez-le de la configuration de l'hôte, retirez le paquet npm, supprimez ~/.mojulo/ et les deux caches ci-dessus. Les moteurs et ouvriers que vous avez installés vous-même vous appartiennent, à garder ou à retirer.