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
requiere·node 22.12+·apache‑2.0·funciona en local·sin cuenta

cuatro pasosinstalar · orientar · acuñar · editar

1

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.

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.

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

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.

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

en disco

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

descargado después, solo si hace falta

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

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.

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

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.