empezarsin clave de api · sin cuenta
Pruebe mojulo headless en un agente web, o instálelo en local.
No instale mojulo usted mismo; lo hace su agente, preguntando antes de cada paso. Puede hacerlo en dos lugares: headless, en la caja Linux desechable que un agente web se da a sí mismo — nada en su máquina, y la caja desaparece cuando termina la sesión — o en su propia máquina, donde vive el bucle completo. La misma instalación, las mismas recetas, las mismas exportaciones. Luego usted le pide algo pequeño. Lo que vuelve se conserva como una receta — un archivo pequeño que lo rehace exactamente, y que sobrevive al chat y a la caja. Sin clave de API, sin cuenta, sin telemetría externa, en ambos casos.
npx mojulo init
dos vías de entradaheadless en una caja · o el bucle completo en su máquina
Pruébelo headless
en el sandbox de un agente web · nada en su máquina
Un agente web — Claude Code en la web, ChatGPT, Grok chat, Meta Muse — se da a sí mismo una caja Linux, desechable en la mayoría de los hosts. Mojulo se instala ahí, y el agente es la única superficie: sin panel, sin ventana, sin imágenes fijas. Lo que hace vuelve como archivos por la puerta que tenga el agente, y como la receta en su informe. La caja desaparece cuando termina la sesión; la receta es lo que usted conserva, y cualquier mojulo la vuelve a acuñar byte a byte.
Necesita una caja Linux con Node 22.12+ y npm accesible. Que la caja tenga internet es regla del host, no de mojulo. Mientras vive, lo que hizo está en la máquina de ese proveedor bajo su política; mojulo en sí sigue sin enviar nada a ninguna parte.
npx -y mojulo init --yes --no-ui
Instálelo en local
macOS · windows · linux · el bucle completo
Su propio agente — Claude Code, Codex, Grok Build, Hermes, cualquier host MCP — lo instala en
su máquina. Este es el bucle completo: el panel en localhost:3001,
las imágenes fijas, los workers en su PATH — Blender, un laminador, un motor —
y todo bajo un solo directorio, ~/.mojulo/.
También es adonde vuelve a casa una receta de una caja: péguela, y lo mismo se regenera aquí, exactamente.
npx mojulo init
cuatro pasosinstalar · orientar · acuñar · editar
Pegue el prompt de donde está su agente
No instale nada usted mismo — entregue el trabajo al agente que ya ejecuta. En un agente web el prompt es una frase; el de su máquina comprueba primero y pregunta antes de cada paso.
Headless, en un agente web. La frase es casi la misma en todas partes. Lo que cambia es la puerta por la que vuelve el archivo, y la línea bajo cada host dice cuál, y qué se vio en una ejecución. Luego pida algo pequeño, y pida el JSON de la receta en la respuesta — esa es la única puerta que toda caja tiene, y todo lo que una instalación local necesita para regenerar la cosa.
Claude Code en la webheadless · puerta: la herramienta de artefactos
ejecutado · 2026-09-21
open a linux box and install mojulo npm package in it
Esa frase es toda la instalación: el agente abre su caja,
ejecuta init --yes sin teclado e informa. El 2026-09-21 una
sesión web de Claude Code hizo esto, acuñó un teléfono de 47 piezas a escala real y
devolvió el glTF; la herramienta de artefactos es la puerta, una página autocontenida
cada vez.
ChatGPTMCP conectado, o headless en modo trabajo · puerta: el informe
ejecutado · 2026-09-22
on work mode, open a linux box and install mojulo npm package in it
ChatGPT pregunta antes de abrir la caja — pulse aceptar. El 2026-09-22, en modo trabajo (work mode), instaló mojulo, lo conectó, llegó al panel en loopback y acuñó una cosa sin clave. Fuera del modo trabajo su caja no tenía internet, así que ahí no se instaló nada — la salida de red de la caja es regla del plan, no de mojulo. Sacar un archivo de esta caja todavía no se ha ejecutado; la receta en la respuesta es la puerta. Con un servidor MCP de mojulo ya conectado, ChatGPT usa ese en su lugar; la guía de ChatGPT cubre ambos.
Grok chatheadless · solo shell · puerta: una tarjeta de archivo
ejecutado · 2026-09-21
open a linux box and install mojulo npm package in it
El sandbox de Grok chat tiene un shell y ningún cliente MCP, así que tras la
instalación maneja el mismo registro desde la línea de comandos —
npx mojulo call <tool>. El 2026-09-21 acuñó una ciudad y
la exportó así; la tarjeta de archivo es la puerta, y world.html
se abre desde el disco sin servidor. Esto es Grok chat, no Grok Build — la CLI
es un host MCP real en su propia máquina, y acepta el prompt local de abajo.
Meta Museheadless · VM persistente · solo CLI · puerta: Artifacts y la Library
ejecutado · 2026-09-23
open a linux box and install mojulo npm package in it
Muse maneja una sola VM Linux persistente detrás de todos sus clientes, con un
shell y sin cliente MCP, así que ejecuta mojulo desde la línea de comandos —
npx mojulo call <tool>, empezando por
npx mojulo orient. A diferencia de las otras cajas, esa VM conserva
~/.mojulo/ entre conversaciones. Las páginas salen por su
herramienta Artifacts y los archivos por su Library.
En su propia máquina. 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 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. 4. Cuando termine, dime que abra una sesión nueva y te pregunte: «¿qué es esto?» Nunca instales nada en mi máquina sin preguntarme antes.
Lo que se descarga, en cualquiera de los dos lugares: un paquete de 6.7 MB que
llega a unos 227 MB en disco con sus dependencias, medidos en una
máquina, y ningún modelo — la búsqueda ordena por las palabras de su petición hasta que usted opte
por mojulo install recall. El panel es un paquete aparte,
que se descarga solo cuando lo abre. El navegador que hornea imágenes fijas no
está en la instalación: un render explícito descarga uno la primera vez que lo necesita
(alrededor de medio gigabyte) si no hay ninguno en la máquina, nunca en la instalación, y si ya hay
un Chrome, Chromium, Edge o Brave 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 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 ello, sin agente de por medio.
Esa vía por shell es exactamente como la ejecuta el sandbox de Grok chat. Cuando
init no tiene terminal a la que preguntar — una tubería, CI, la caja de un agente — no cambia
nada sin --yes: imprime su plan y sale con 2.
npx -y mojulo init --yes --no-ui es la forma explícita.
En Claude Code, el plugin. /plugin marketplace add
zombico/mojulo, y luego /plugin install mojulo@mojulo, arranca el mismo
servidor fijado a una versión. Use el plugin o init para Claude Code, no
ambos: dos registros ejecutan dos servidores.
¿Ya en 2.x? Un npx mojulo sin versión fijada pasa a 3.0 en
su próximo arranque, y 3.0 recifra en un solo sentido las claves de proveedor guardadas, así que haga primero una copia de
~/.mojulo/secret.key junto con la base de datos. La fábrica de chatbots ya no
forma parte de mojulo desde la 3.0 y pasa a un proyecto propio. Las versiones 2.x anteriores
que la incluyen no tienen mantenimiento y tienen problemas de seguridad conocidos. Los pasos están en
Upgrading from 2.x.
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. Headless, el agente hace la misma pregunta desde dentro de su caja y devuelve la respuesta.
¿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 para retomarla la semana que viene — en su disco, o en el informe que devolvió la caja.
Headless, pida la página, no una imagen fija: puede que la caja no tenga
navegador con el que hornear una imagen, pero el world.html exportado es
autocontenido y se abre desde el disco. Cada exportación que el agente escribe le dice
qué puerta tiene este host, así que sabe cómo devolver el archivo. Y conserve la
receta — la caja no lo hará.
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, o un shell. Claude Code o Codex le sacan el máximo
partido; Claude Desktop y otros hosts se conectan por perfil declarado. Sin ningún cliente
MCP, npx mojulo call maneja el mismo registro.
Su máquina. Construido y verificado en macOS, Apple Silicon.
Linux: la suite de pruebas corre en Ubuntu en CI, y una instalación limpia 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.
O la caja de su agente. Una caja Linux con Node y npm accesibles, headless: sin panel que pueda abrir, sin imágenes fijas, los archivos y la receta salen por la puerta del host. Ejecutado en Claude Code en la web (2026-09-21), en ChatGPT en modo trabajo (2026-09-22), en el sandbox de Grok chat, solo shell (2026-09-21), y en la VM persistente de Meta Muse, solo shell (2026-09-23). Una tarea en la nube de Codex: según su documentación, internet apagado por defecto. Blender se instala en esas cajas; los laminadores y los motores de juego no, y los paquetes de exportación se escriben en ambos casos.
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 6.7 MB, 21.3 MB descomprimido, ~227 MB instalado con
sus dependencias (153 paquetes) — medidos el 2026-09-30 con mojulo 3.0.0 en
macOS arm64. Un arranque en frío descarga unos 79 MB y deja unos
140 MB en la caché de npm, y respondió a initialize en una mediana de 4.5 s
a través de un sustituto local del registro; el registro real es más lento. Los ayudantes
creativos (audio, booleanas exactas, imágenes) están dentro de esa cifra;
npm install --omit=optional quita unos 115 MB de ellos. El
panel, mojulo-ui, ocupa 12.7 MB empaquetado y 57.0 MB descomprimido,
y se descarga solo cuando lo abre.
Sin modelo. Una instalación por defecto no descarga ninguno; la búsqueda sigue respondiendo, ordenando por las palabras de su petición. El modelo de embeddings es el opt-in de abajo.
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 render explícito 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é bajo
~/.mojulo/; la hoja completa nombra las variables que los mueven. Bajo
el plugin de Claude ninguno se descarga nunca por su cuenta: usa un navegador y un
ffmpeg que usted ya tiene.
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.
Búsqueda que ordena por significado — mojulo install recall
añade el modelo de embeddings: ~480 MB de runtime y un modelo de ~130 MB en
~/.mojulo/, conservados entre actualizaciones. La mayoría de las sesiones nunca lo necesitan; el
agente lee el índice de herramientas directamente.
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 externa. Arrancar el servidor no hace ninguna llamada
de red. El tráfico saliente ocurre solo en una acción con nombre: npm descargando el paquete,
las descargas únicas de arriba, check_for_updates cuando su agente
lo llama, el paquete del panel cuando lo abre, y lo que haga el proveedor propio de su
agente — ese tráfico es del agente, no de mojulo. El único registro que
guarda el software, de sus propias llamadas a herramientas, se queda en su máquina; la
lista
completa está en el repositorio.
En una caja, la salida de red es regla del host. Una tarea en la nube de Codex viene con internet apagado; la caja de ChatGPT fuera del modo trabajo no tenía. Mojulo necesita npm accesible una vez, en la instalación, y nada después.
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.