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
requiere·node 22.12+·apache‑2.0·funciona donde funciona su agente·sin cuenta

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
en ambos casos·sin clave de api·sin cuenta·sin telemetría externa·solo loopback

cuatro pasosinstalar · orientar · acuñar · editar

1

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.

2

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.

3

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.

4

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.

tú
modela un farol de huracán a escala real que pueda orbitar en 3D
agente
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.
tú
el asa está flotando
agente
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.
tú
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.

para ejecutar

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.

en disco

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/.

descargado después, solo si hace falta

~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.

opcional · usted instala, mojulo detecta

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.

workers opcionales

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.

red

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.

para desinstalar

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.