empezarsin clave de api · sin cuenta
Cómo pedir a su agente que instale el taller de Mojulo.
Usted no instala mojulo. Pega un solo prompt en el agente de programación que ya ejecuta — Claude Code, Codex, cualquier agente compatible con MCP — y él hace la instalación, preguntando antes de cada paso. Luego le pide algo pequeño. Lo que vuelve se guarda como una receta — un archivo pequeño que lo rehace exactamente y sobrevive al chat. Sin clave de API, sin cuenta, sin telemetría; lo que hace se queda en su máquina.
npx mojulo init
cuatro pasosinstalar · orientar · acuñar · editar
Pegue esto en su agente
No instale nada usted mismo — entregue el trabajo al agente que ya ejecuta. Abra Claude Code o Codex y pegue este prompt. Comprueba primero la máquina, informa de lo que encontró y le pide permiso antes de instalar nada — nada entra en su máquina sin un sí.
Ayúdame a instalar mojulo — una fábrica 3D gratuita y local que manejarás por MCP. Orientación, si puedes descargarla: https://mojulo.ai/llms.txt (réplica si el sitio está caído: https://github.com/zombico/mojulo) 1. Primero solo comprueba: ejecuta `node --version`. Mojulo necesita Node 22.12+. Dime qué encontraste antes de cambiar nada. 2. Si Node falta o es demasiado antiguo, pídeme permiso y luego instálalo como espera esta máquina (brew / winget / nvm / apt). 3. Con mi visto bueno, ejecuta `npx mojulo init`. Conecta mojulo a los agentes de programación de esta máquina (un sí/no por host) y abre un panel en localhost:3001. Todo se queda en mi máquina. 4. Cuando termine, dime que abra una sesión nueva y te pregunte: «¿qué es esto?» Nunca instales nada sin preguntarme antes.
Lo que se descarga: el paquete y su runtime nativo — unos 985 MB en disco, medidos en una máquina — y, en el primer arranque, un modelo de búsqueda de ~130 MB. Las bibliotecas de render 3D están en la instalación por defecto. Lo único que no está es el navegador headless con el que la fábrica hornea imágenes fijas: se descarga la primera vez que un horneado lo necesita (alrededor de medio gigabyte), nunca en la instalación, y si ya hay un Chrome, Chromium, Edge o Brave en la máquina se usa ese en su lugar. Las cifras medidas, y todo lo demás que necesita la máquina, están en requisitos técnicos más abajo.
¿Prefiere manejarlo usted mismo? Instale Node.js 22.12+ desde
nodejs.org y ejecute npx mojulo init. En cualquier caso, todo se ejecuta en
su máquina — el panel se abre en localhost:3001 (o el siguiente
puerto libre; el instalador imprime la URL) y el estado se guarda en
~/.mojulo/. Sin cuenta, sin credenciales que entregar; volver a ejecutar
init repara el cableado antiguo en vez de duplicarlo. La misma
instalación sirve también de línea de comandos — npx mojulo tools lista lo que
hay dentro, npx mojulo call <tool> ejecuta cualquiera de ellas, sin agente
de por medio.
Pregunte a su agente qué está viendo
Abra una sesión nueva del agente — el nuevo cableado se detecta al arrancar — y escriba una línea. Mojulo lee su propio índice de rutas y se orienta en voz alta — sin clave del proveedor, sin llamada a la nube, nada construido todavía.
¿qué es esto?
forward_context — la fábrica explicándose a sí misma. Esta es la interfaz prevista: usted pregunta, su agente descubre la herramienta adecuada y la toma.
Pida algo pequeño
Luego pida algo que sea suyo. Su agente lo escribe, mojulo lo guarda como una pequeña receta determinista y le entrega una URL para abrir.
modela una taza de café en centímetros reales que pueda orbitar → mint_solid
la receta es el artefacto guardado — unas pocas líneas legibles que regeneran la misma taza en cada apertura. el render es derivado y desechable; la receta se queda en su disco para retomarla la semana que viene.
Si una herramienta 3D alguna vez se niega y nombra mojulo install creative,
ejecútelo. Las bibliotecas de render vienen en la instalación por defecto, pero un
npm install --omit=optional o una compilación nativa fallida pueden dejarlas
fuera — y la negativa lo dice en vez de fallar en silencio.
Luego cámbiela
«Hazla más alta.» «Cambia el tono.» Su agente edita unas pocas líneas de la misma receta en el sitio y se vuelve a renderizar; nada se regenera desde una caja negra, y las líneas que cambió están ahí para leerlas.
haz el asa más gruesa y el esmalte negro mate → update_sketch
Una taza es el suelo, no el techo. Qué más hace la fábrica — y adónde puede ir después una cosa terminada — lo nombra el taller cuando tiene algo entre manos, o cuando lo pregunta. Esta página deja de prometer aquí a propósito.
el primer vuelopedir → acuñar → mirar → conservar
Así es como se hizo realmente un objeto real, incluida la parte en que el primer intento estaba mal. La corrección no es un fallo del método; es el método.
modela un farol de huracán a escala real que pueda orbitar en 3D
acuñando — siete perfiles de revolución apilados y un asa barrida: latón, cobre, vidrio, 40 cm de alto. Abre /sketches/sk_jon77cn4ud y orbítalo.
el asa está flotando
así es — los extremos del aro quedan a ±6,5 cm sobre un collar de 3,6 cm. Reasentando el barrido… v2 acuñada. El aro asienta sobre el collar.
guárdalo
mint_solid — la petición es lenguaje llano, una cosa y una escala. nadie tecleó una coordenada: las piezas se colocan por relaciones declaradas (on / gap / radial), y la fábrica las resuelve.
lo que se guarda es la receta — 1,8 KB de perfiles y un trazado. el farol que orbita se deriva de ella en cada render, y el render es desechable.
«el asa está flotando» es el control visual — alguien mira de verdad antes de que una cosa se conserve. la receta hizo barato el fallo: un trazado editado, v2 acuñada, y ambas versiones persisten como recetas que puede comparar.
y después de «guárdalo», las puertas — una cosa conservada puede salir: un archivo para una impresora, una página que puede alojar, habitaciones más grandes que eso. nadie las lista de antemano; el taller nombra las puertas que encajan con la cosa que tiene entre manos, en el momento en que la tiene. las puertas dan a herramientas que ya ejecuta — blender, un motor de juego, un laminador — como archivos que ya leen, y lo que refine ahí puede volver y vincularse a la misma receta.
requisitos técnicosqué necesita · cuánto pesa · qué es opcional
La versión corta de lo que mojulo le pide a una máquina. Cada cifra se midió en una máquina en una fecha declarada; la hoja completa, hasta el tamaño de cada dependencia, vive en el repositorio.
Node.js 22.12 o más reciente. El único requisito duro; un Node más antiguo sale con un mensaje en vez de funcionar a medias.
Un host MCP. Claude Code o Codex le sacan el máximo partido; Claude Desktop y otros hosts se conectan por perfil declarado.
Un sistema operativo de escritorio. Construido y verificado en macOS, Apple Silicon.
Linux: la suite de pruebas corre en Ubuntu en CI, y una instalación limpia de 2.0.1
se comprobó en Linux x64 y arm64; las comprobaciones de motores más abajo no están
verificadas ahí. Windows: verificado en una máquina Windows nativa con Claude Code —
npx mojulo init se completó y llegó un primer render; Codex ahí, y las
comprobaciones de motores más abajo, no se han comprobado.
Sin GPU, sin clave del proveedor, sin cuenta. Las imágenes fijas se hornean en la CPU. Su agente es el bucle de razonamiento; una clave entra solo cuando algo debe pintar.
Tarball de 36 MB, ~985 MB en disco tras
npx mojulo init — medidos el 2026-09-11 con mojulo 2.0.2 en
macOS arm64. Las bibliotecas de render 3D están dentro de esa cifra;
npm install --omit=optional las quita (~86 MB) y
mojulo install creative las vuelve a poner.
Modelo de búsqueda de ~130 MB, descargado una vez en el primer arranque
en ~/.mojulo/models/.
Kilobytes por receta. Todo lo que hace es un solo archivo SQLite
en ~/.mojulo/data/.
~500 MB de Chrome headless, la primera vez que un horneado lo necesita — se omite cuando Chrome, Chromium, Edge o Brave ya está en la máquina.
~19 MB de ffmpeg, la primera vez que se unen clips en
un MP4 — se omite cuando ffmpeg ya está en su PATH.
Nada se descarga en la instalación. Estos dos se guardan en caché dentro del directorio
del paquete y no en ~/.mojulo/; la hoja completa nombra las
variables que los mueven.
Godot 4.5 o más reciente (gratuito) abre un paquete de juego como proyecto. Blender 4.x o más reciente (gratuito) recibe el pase de arte y el horneado. Unity 6, activado, con el paquete glTFast desde el Package Manager. Unreal 5.4 o más reciente; un paquete de juego compila C++, así que Xcode en macOS o Visual Studio en Windows.
Un laminador — PrusaSlicer o Bambu Studio — estampa una comprobación de impresión headless junto al STL o 3MF; cualquier laminador abre el archivo.
Toda exportación funciona sin ninguno de estos instalados: el paquete y su guía de importación paso a paso se escriben igualmente, y la comprobación de la máquina informa «omitido» con el motivo. Los motores son instalaciones de varios gigabytes bajo sus propias licencias; mojulo nunca descarga ni configura ninguno.
Instalaciones aparte que ejecuta usted mismo; mojulo nunca las arranca ni depende de ellas, y su ausencia apaga un bucle y no rompe nada. ComfyUI con Qwen-Image-Edit pinta cuando su agente no puede — ~31 GB, o un quant de ~17 GB en Apple Silicon. Kokoro pone voz a la narración — ~92 MB. TripoSR esculpe detalle de superficie sobre el greybox — ~1,4 GB.
Sin telemetría. El tráfico saliente solo ocurre con acciones
explícitas: npm descargando el paquete, las descargas únicas de arriba,
check_for_updates cuando su agente lo llama, y lo que haga el propio
proveedor de su agente — ese tráfico es del agente, no de mojulo.
Desconéctelo de la configuración del host, elimine el paquete npm, borre
~/.mojulo/ y las dos cachés de arriba. Los motores y workers que
instaló usted mismo son suyos para conservarlos o eliminarlos.