시작하기api 키 불필요 · 계정 불필요
웹 에이전트에서 mojulo를 헤드리스로 써 보거나, 로컬에 설치하세요.
mojulo는 직접 설치하지 않습니다. 에이전트가 설치하며, 단계마다 먼저 물어봅니다. 설치는 두 곳에서 할 수 있습니다: 헤드리스로, 웹 에이전트가 스스로 마련하는 일회용 Linux 박스에서 — 내 컴퓨터에는 아무것도 없고, 세션이 끝나면 박스도 사라집니다 — 또는 전체 루프가 있는 내 컴퓨터에서. 설치도, 레시피도, 내보내기도 같습니다. 그다음 작은 것 하나를 요청하세요. 돌아오는 것은 레시피로 보관됩니다 — 그것을 그대로 다시 만들어 내는 작은 파일이며, 채팅과 박스보다 오래갑니다. 어느 쪽이든 API 키도, 계정도, 외부 텔레메트리도 없습니다.
npx mojulo init
들어가는 두 길박스에서 헤드리스로 · 또는 내 컴퓨터에서 전체 루프로
헤드리스로 써 보기
웹 에이전트의 샌드박스에서 · 내 컴퓨터에는 아무것도 없음
웹 에이전트 — 웹의 Claude Code, ChatGPT, Grok chat, Meta Muse — 는 스스로 Linux 박스를 마련하며, 대부분의 호스트에서 일회용입니다. Mojulo는 거기에 설치되고, 에이전트가 유일한 화면입니다: 대시보드도, 창도, 정지 이미지도 없습니다. 만든 것은 에이전트가 가진 문을 통해 파일로, 그리고 보고서 안의 레시피로 돌아옵니다. 세션이 끝나면 박스는 사라지고, 남는 것은 레시피이며, 어느 mojulo든 그것을 바이트 단위로 똑같이 다시 생성합니다.
Node 22.12+가 있고 npm에 닿을 수 있는 Linux 박스가 필요합니다. 박스에 인터넷이 있는지는 mojulo가 아니라 호스트의 규칙입니다. 박스가 살아 있는 동안 만든 것은 그 벤더의 머신에 그들의 정책 아래 놓입니다. mojulo 자체는 여전히 아무것도 어디로도 보내지 않습니다.
npx -y mojulo init --yes --no-ui
로컬에 설치하기
macOS · windows · linux · 전체 루프
내 에이전트 — Claude Code, Codex, Grok Build, Hermes, 모든 MCP 호스트 — 가 내 컴퓨터에 설치합니다. 이쪽이 전체 루프입니다: localhost:3001의 대시보드, 정지 이미지, PATH에 있는 워커 — Blender, 슬라이서, 엔진 — 그리고 모든 것이 하나의 디렉터리 ~/.mojulo/ 아래에 있습니다.
박스에서 나온 레시피가 돌아오는 집이기도 합니다: 붙여 넣으면 같은 것이 여기서 똑같이 다시 생성됩니다.
npx mojulo init
네 단계설치 · 파악 · 생성 · 수정
에이전트가 있는 곳에 맞는 프롬프트를 붙여 넣으세요
직접 아무것도 설치하지 마세요 — 이미 쓰고 있는 에이전트에 그 일을 넘기면 됩니다. 웹 에이전트에서는 프롬프트가 한 문장입니다. 내 컴퓨터용 프롬프트는 먼저 확인하고 매 단계마다 물어봅니다.
웹 에이전트에서 헤드리스로. 문장은 어디서나 거의 같습니다. 다른 것은 파일이 돌아오는 문이며, 각 호스트 아래의 줄이 그것이 어느 문인지, 그리고 실행에서 무엇이 확인되었는지 말해 줍니다. 그다음 작은 것 하나를 요청하고, 답변에 레시피 JSON을 넣어 달라고 하세요 — 그것이 모든 박스가 가진 단 하나의 문이고, 로컬 설치가 그것을 다시 생성하는 데 필요한 전부입니다.
웹의 Claude Code헤드리스 · 문: 아티팩트 도구
실행 · 2026-09-21
open a linux box and install mojulo npm package in it
그 문장이 설치의 전부입니다: 에이전트가 박스를 열고, 키보드 없이 init --yes를 실행하고, 보고합니다. 2026-09-21에 웹의 Claude Code 세션이 이렇게 해서 47개 부품으로 된 휴대폰을 실제 크기로 생성하고 glTF를 돌려주었습니다. 문은 아티팩트 도구이며, 한 번에 하나의 자체 완결형 페이지입니다.
ChatGPT연결된 MCP, 또는 work 모드에서 헤드리스 · 문: 보고서
실행 · 2026-09-22
on work mode, open a linux box and install mojulo npm package in it
ChatGPT는 박스를 열기 전에 먼저 물어봅니다 — 수락을 누르세요. 2026-09-22에 work 모드에서 mojulo를 설치하고, 연결하고, 루프백 대시보드에 접속해 키가 필요 없는 것 하나를 생성했습니다. work 모드 밖에서는 박스에 인터넷이 없어 아무것도 설치되지 않았습니다 — 박스의 외부 통신은 요금제의 규칙이지 mojulo의 규칙이 아닙니다. 이 박스에서 파일을 내보내는 것은 아직 실행해 보지 않았고, 답변 속 레시피가 문입니다. mojulo MCP 서버가 이미 연결되어 있으면 ChatGPT는 그쪽을 씁니다. ChatGPT 가이드가 둘 다 다룹니다.
Grok chat헤드리스 · 셸만 · 문: 파일 카드
실행 · 2026-09-21
open a linux box and install mojulo npm package in it
Grok chat의 샌드박스에는 셸은 있고 MCP 클라이언트는 없습니다. 그래서 설치 후에는 같은 레지스트리를 커맨드 라인에서 조작합니다 — npx mojulo call <tool>. 2026-09-21에 이 방식으로 도시 하나를 생성하고 내보냈습니다. 파일 카드가 문이고, world.html은 서버 없이 디스크에서 열립니다. 이것은 Grok Build가 아니라 Grok chat입니다 — 그 CLI는 내 컴퓨터에서 도는 진짜 MCP 호스트이며, 아래의 로컬 프롬프트를 받습니다.
Meta Muse헤드리스 · 영속 VM · CLI만 · 문: 아티팩트와 라이브러리
실행 · 2026-09-23
open a linux box and install mojulo npm package in it
Muse는 모든 클라이언트 뒤에서 영속 Linux VM 하나를 구동하며, 셸은 있지만 MCP 클라이언트는 없어서 명령줄로 mojulo를 실행합니다 — npx mojulo call <tool>, 시작은 npx mojulo orient. 다른 박스와 달리 그 VM은 대화 사이에도 ~/.mojulo/를 유지합니다. 페이지는 아티팩트 도구로, 파일은 라이브러리로 나갑니다.
내 컴퓨터에서. Claude Code나 Codex를 열고 이 프롬프트를 붙여 넣으세요. 먼저 컴퓨터를 확인하고, 무엇을 찾았는지 알려주고, 무엇이든 설치하기 전에 허락을 구합니다 — 예라고 하지 않으면 아무것도 컴퓨터에 들어오지 않습니다.
mojulo 설치를 도와줘 — MCP로 네가 조작할 무료 3D 팩토리야. 가져올 수 있으면 참고 자료: https://mojulo.ai/llms.txt (사이트가 죽어 있으면 미러: https://github.com/zombico/mojulo) 1. 먼저 확인만 해: `node --version`을 실행해. mojulo는 Node 22.12+가 필요해. 아무것도 바꾸기 전에 무엇을 찾았는지 알려줘. 2. Node가 없거나 너무 낮으면 내 허락을 구하고, 이 컴퓨터에 맞는 방식으로 설치해 (brew / winget / nvm / apt). 3. 내가 좋다고 하면 `npx mojulo init`을 실행해. 이 컴퓨터의 코딩 에이전트에 mojulo를 연결하고(호스트마다 예/아니오 한 번) localhost:3001에 대시보드를 열어. 4. 끝나면 새 세션을 열고 네게 이렇게 물으라고 말해줘: "이게 뭐야?" 먼저 나에게 묻지 않고는 내 컴퓨터에 아무것도 설치하지 마.
어느 쪽에서든 내려받는 것: 6.7 MB 패키지이며, 의존성을 포함하면 디스크에서 약 227 MB가 됩니다(한 대의 컴퓨터에서 측정). 모델은 없습니다 — mojulo install recall을 선택하기 전까지 검색은 요청에 쓴 단어로 순위를 매깁니다. 대시보드는 별도 패키지이며, 열 때만 가져옵니다. 정지 이미지를 굽는 브라우저는 설치에 포함되어 있지 않습니다: 명시적 렌더가 처음 필요할 때, 컴퓨터에 없으면 하나를 가져오며(약 0.5기가바이트), 설치 시점에는 가져오지 않습니다. 이미 있는 Chrome, Chromium, Edge, Brave는 대신 그것을 씁니다. 측정한 수치와 컴퓨터에 필요한 나머지 모든 것은 아래의 기술 요구 사항에 있습니다.
직접 하고 싶다면? nodejs.org에서 Node.js 22.12+를 설치하고 npx mojulo init을 실행하세요. 내 컴퓨터에서는 대시보드가 localhost:3001에서 열리고(또는 다음 빈 포트. 설치 프로그램이 URL을 출력합니다) 상태는 ~/.mojulo/에 저장됩니다. 계정도, 넘겨줄 자격 증명도 없습니다. init을 다시 실행하면 이전 연결을 중복시키지 않고 고칩니다. 같은 설치가 명령줄도 겸합니다 — npx mojulo tools는 안에 무엇이 있는지 나열하고, npx mojulo call <tool>은 그중 무엇이든 실행하며, 루프에 에이전트는 없습니다. Grok chat의 샌드박스가 정확히 이 셸 경로로 실행합니다. init이 물어볼 터미널이 없으면 — 파이프, CI, 에이전트의 박스 — --yes 없이는 아무것도 바꾸지 않습니다: 계획을 출력하고 종료 코드 2로 끝납니다. npx -y mojulo init --yes --no-ui가 명시적 표기입니다.
Claude Code에서는 플러그인. /plugin marketplace add
zombico/mojulo에 이어 /plugin install mojulo@mojulo를 실행하면 같은 서버가 한 버전에 고정되어 시작됩니다. Claude Code에는 플러그인이나 init 중 하나만 쓰세요, 둘 다는 안 됩니다: 등록이 두 개면 서버도 두 개가 실행됩니다.
이미 2.x를 쓰고 있나요? 고정하지 않은 npx mojulo는 다음 시작 때 3.0으로 넘어가며, 3.0은 저장된 프로바이더 키를 되돌릴 수 없게 다시 암호화하므로 먼저 데이터베이스와 함께 ~/.mojulo/secret.key를 백업하세요. 챗봇 팩토리는 3.0부터 더 이상 mojulo의 일부가 아니며 자체 프로젝트로 옮겨 가는 중입니다. 그것을 포함한 이전 2.x 버전은 유지 관리되지 않으며 알려진 보안 문제가 있습니다. 절차는 Upgrading from 2.x에 있습니다.
에이전트에게 지금 무엇을 보고 있는지 물어보세요
새 에이전트 세션을 열고 — 새 연결은 시작할 때 인식됩니다 — 한 줄을 입력하세요. mojulo가 자신의 라우팅 인덱스를 읽고 소리 내어 스스로를 파악합니다 — 프로바이더 키도, 클라우드 호출도 없고, 아직 만든 것도 없습니다. 헤드리스에서는 에이전트가 박스 안에서 같은 질문을 던지고 답을 보고해 줍니다.
이게 뭐야?
forward_context — 팩토리가 스스로를 설명하는 것입니다. 이것이 의도된 인터페이스입니다: 당신이 묻고, 에이전트가 맞는 도구를 찾아 그것에 손을 뻗습니다.
작은 것 하나를 요청하세요
그다음엔 당신 것을 요청하세요. 에이전트가 그것을 작성하고, mojulo가 작고 결정론적인 레시피로 보관하며, 열어 볼 URL을 건네줍니다.
돌려볼 수 있는 실제 센티미터 단위 커피 머그컵을 만들어줘 → mint_solid
저장되는 산출물은 레시피입니다 — 열 때마다 같은 머그컵을 다시 생성하는, 읽을 수 있는 몇 줄입니다. 렌더는 파생물이고 버려도 됩니다. 레시피는 남아서 다음 주에 다시 집어 들 수 있습니다 — 디스크에, 또는 박스가 돌려준 보고서 안에.
헤드리스에서는 정지 이미지가 아니라 페이지를 요청하세요: 박스에는 그림을 베이크할 브라우저가 없을 수 있지만, 내보낸 world.html은 하나로 완결되어 디스크에서 열립니다. 에이전트가 작성하는 모든 내보내기는 이 호스트에 어떤 문이 있는지 에이전트에게 알려주므로, 파일을 어떻게 돌려줄지 알고 있습니다. 그리고 레시피는 직접 보관하세요 — 박스는 보관해 주지 않습니다.
3D 도구가 거부하면서 mojulo install creative를 언급하면, 그것을 실행하세요. 렌더 라이브러리는 기본 설치에 들어 있지만, npm install --omit=optional이나 실패한 네이티브 빌드가 그것을 빠뜨릴 수 있습니다 — 그리고 그럴 때는 조용히 실패하는 대신 거부하면서 그렇다고 말합니다.
그다음 바꿔 보세요
"더 높게 만들어줘." "색조를 바꿔줘." 에이전트가 같은 레시피의 몇 줄을 그 자리에서 고치면 다시 렌더됩니다. 블랙박스에서 다시 생성되는 것은 없고, 바뀐 줄은 읽어 볼 수 있게 그대로 있습니다.
손잡이를 더 두껍게, 유약은 무광 검정으로 → update_sketch
머그컵은 바닥이지 천장이 아닙니다. 팩토리가 또 무엇을 만드는지 — 그리고 완성된 것이 다음에 어디로 갈 수 있는지 — 는 손에 무언가를 들고 있을 때, 또는 물어볼 때 공방이 알려줍니다. 이 페이지는 일부러 여기서 약속을 멈춥니다.
첫 비행요청 → 생성 → 확인 → 보관
이것은 실제 물건이 실제로 만들어진 과정이며, 첫 시도가 틀렸던 부분까지 포함합니다. 그 수정은 방법의 실패가 아닙니다. 그것이 바로 방법입니다.
3D로 돌려볼 수 있게 실제 크기로 허리케인 랜턴을 만들어줘
생성 중 — 쌓아 올린 선반 프로파일 일곱 개와 스윕 손잡이 하나: 황동, 구리, 유리, 높이 40 cm. /sketches/sk_jon77cn4ud를 열고 돌려보세요.
손잡이가 떠 있어
정말 그렇네요 — 후프의 끝이 3.6 cm 칼라 위 ±6.5 cm에 있습니다. 스윕을 다시 앉히는 중… v2 생성 완료. 후프가 칼라에 닿습니다.
이거 유지해
mint_solid — 요청은 평범한 말, 물건 하나와 크기 하나입니다. 아무도 좌표를 입력하지 않았습니다: 부품은 선언된 관계(on / gap / radial)로 배치되고, 팩토리가 그것을 풀어냅니다.
저장되는 것은 레시피입니다 — 프로파일들과 경로 하나로 된 1.8 KB. 돌려보는 랜턴은 렌더할 때마다 그것에서 파생되고, 렌더는 버려도 됩니다.
"손잡이가 떠 있어"가 눈의 게이트입니다 — 무언가를 보관하기 전에 누군가 실제로 눈으로 봅니다. 레시피가 그 실수를 값싸게 만들었습니다: 경로 하나를 고치고, v2를 생성하고, 두 버전 모두 diff할 수 있는 레시피로 남습니다.
그리고 "이거 유지해" 다음에는 문들이 있습니다 — 보관된 것은 밖으로 나갈 수 있습니다: 프린터용 파일, 호스팅할 수 있는 페이지, 그보다 큰 방들. 아무도 그것을 미리 나열하지 않습니다. 공방은 당신이 들고 있는 것에 맞는 문을, 들고 있는 그 순간에 알려줍니다. 그 문들은 이미 쓰고 있는 도구들 — blender, 게임 엔진, 슬라이서 — 로 열리고, 그 도구들이 이미 읽는 파일로 건네집니다. 그리고 거기서 다듬은 것은 다시 돌아와 같은 레시피에 결합될 수 있습니다.
기술 요구 사항무엇이 필요한지 · 얼마나 무거운지 · 무엇이 선택인지
mojulo가 컴퓨터에 요구하는 것의 요약판입니다. 모든 수치는 명시된 날짜에 한 대의 컴퓨터에서 측정했습니다. 각 의존성의 크기까지 담은 전체 시트는 리포지토리에 있습니다.
Node.js 22.12 이상. 유일한 절대 조건입니다. 더 낮은 Node는 어중간하게 동작하는 대신 메시지를 내고 종료합니다.
MCP 호스트, 또는 셸. Claude Code나 Codex가 가장 잘 활용합니다. Claude Desktop과 다른 호스트는 선언된 프로파일로 연결됩니다. MCP 클라이언트가 전혀 없으면 npx mojulo call이 같은 레지스트리를 조작합니다.
내 컴퓨터. macOS, Apple Silicon에서 빌드하고 검증했습니다. Linux: 테스트 스위트는 CI의 Ubuntu에서 실행되며, 새 설치를 Linux x64와 arm64에서 확인했습니다. 아래의 엔진 확인 항목은 거기서 검증되지 않았습니다. Windows: 네이티브 Windows 머신에서 Claude Code로 검증했습니다 — npx mojulo init이 완료되고 첫 렌더가 나왔습니다. 그곳의 Codex와 아래의 엔진 확인 항목은 확인하지 않았습니다.
아니면 에이전트의 박스. Node와 npm에 닿을 수 있는 Linux 박스, 헤드리스: 열 수 있는 대시보드도, 정지 이미지도 없고, 파일과 레시피는 호스트의 문을 통해 나갑니다. 웹의 Claude Code(2026-09-21), work 모드의 ChatGPT(2026-09-22), Grok chat의 샌드박스 — 셸만(2026-09-21), Meta Muse의 영속 VM — 셸만(2026-09-23)에서 실행했습니다. Codex 클라우드 태스크: 문서에 따르면 인터넷은 기본으로 꺼져 있습니다. 이 박스들에서는 Blender가 설치되고, 슬라이서와 게임 엔진은 설치되지 않으며, 내보내기 팩은 어느 쪽이든 작성됩니다.
GPU 불필요, 프로바이더 키 불필요, 계정 불필요. 정지 이미지는 CPU에서 베이크됩니다. 추론 루프는 당신의 에이전트입니다. 키는 무언가를 그려야 할 때만 등장합니다.
6.7 MB 타볼, 21.3 MB 압축 해제 시, 의존성 포함 설치 시 ~227 MB(153개 패키지) — macOS arm64에서 mojulo 3.0.0을 기준으로 2026-09-30에 측정했습니다. 콜드 스타트는 약 79 MB를 다운로드하고 npm 캐시에 약 140 MB를 남기며, 로컬 레지스트리 대역을 거쳐 initialize에 중앙값 4.5 s로 응답했습니다. 실제 레지스트리는 더 느립니다. 크리에이티브 헬퍼(오디오, 정확한 불리언, 이미지)는 그 수치에 포함되어 있으며, npm install --omit=optional은 그중 약 115 MB를 덜어 냅니다. 대시보드 mojulo-ui는 압축 시 12.7 MB, 압축 해제 시 57.0 MB이며 열 때만 가져옵니다.
모델 없음. 기본 설치는 어떤 모델도 가져오지 않습니다. 검색은 여전히 답하며, 요청에 쓴 단어로 순위를 매깁니다. 임베딩 모델은 아래의 선택 항목입니다.
레시피당 킬로바이트. 만든 모든 것은 ~/.mojulo/data/ 아래 하나의 SQLite 파일입니다.
~500 MB 헤드리스 Chrome, 명시적 렌더가 처음 그것을 필요로 할 때 — 컴퓨터에 Chrome, Chromium, Edge, Brave가 이미 있으면 건너뜁니다.
~19 MB ffmpeg, 클립을 처음 MP4로 이어 붙일 때 — ffmpeg가 이미 PATH에 있으면 건너뜁니다.
설치 시점에는 아무것도 다운로드하지 않습니다. 이 두 개는 ~/.mojulo/ 아래에 캐시되며, 전체 시트가 그 위치를 바꾸는 변수들을 알려줍니다. Claude 플러그인에서는 둘 다 스스로 가져오는 일이 없습니다: 이미 있는 브라우저와 ffmpeg를 씁니다.
Godot 4.5 이상(무료)은 게임 팩을 프로젝트로 엽니다. Blender 4.x 이상(무료)은 아트 패스와 베이크를 맡습니다. Unity 6는 활성화된 상태로, Package Manager의 glTFast 패키지와 함께. Unreal 5.4 이상. 게임 팩은 C++를 컴파일하므로 macOS에서는 Xcode, Windows에서는 Visual Studio가 필요합니다.
슬라이서 — PrusaSlicer 또는 Bambu Studio — 가 STL이나 3MF 옆에 헤드리스 출력 검사를 찍어 둡니다. 파일 자체는 어떤 슬라이서에서든 열립니다.
의미로 순위를 매기는 검색 — mojulo install recall이 임베딩 모델을 추가합니다: ~/.mojulo/ 아래에 ~480 MB의 런타임과 ~130 MB의 모델이 놓이고, 업그레이드해도 유지됩니다. 대부분의 세션에는 필요 없습니다. 에이전트가 도구 인덱스를 직접 읽습니다.
이 중 아무것도 설치하지 않아도 모든 내보내기는 동작합니다: 팩과 단계별 임포트 안내는 어느 쪽이든 작성되고, 머신 확인은 이유와 함께 "건너뜀"으로 보고합니다. 엔진들은 각자의 라이선스 아래 있는 수 기가바이트 설치이며, mojulo는 그중 어느 것도 다운로드하거나 설정하지 않습니다.
당신이 직접 실행하는 별도 설치입니다. mojulo는 그것을 시작하지도, 그것에 의존하지도 않으며, 없으면 루프 하나가 꺼질 뿐 아무것도 깨지지 않습니다. ComfyUI와 Qwen-Image-Edit는 에이전트가 그릴 수 없을 때 그립니다 — ~31 GB, Apple Silicon에서는 ~17 GB 양자화 버전. Kokoro는 내레이션을 읽습니다 — ~92 MB. TripoSR는 그레이박스 위에 표면 디테일을 조형합니다 — ~1.4 GB.
외부 텔레메트리 없음. 서버를 시작해도 네트워크 호출이 없습니다. 외부로 나가는 트래픽은 지정된 동작에서만 발생합니다: npm이 패키지를 가져올 때, 위의 일회성 다운로드, 에이전트가 호출할 때의 check_for_updates, 대시보드를 열 때의 대시보드 패키지, 그리고 에이전트 자체 프로바이더가 하는 모든 것 — 그 트래픽은 에이전트의 것이지 mojulo의 것이 아닙니다. 소프트웨어가 남기는 유일한 로그인 자체 도구 호출 기록은 내 컴퓨터에 남습니다. 전체
목록은 저장소에 있습니다.
박스에서 외부 접속은 호스트의 규칙입니다. Codex 클라우드 작업은 인터넷이 꺼진 채로 제공됩니다. work 모드 밖의 ChatGPT 박스에는 인터넷이 없었습니다. mojulo는 설치 때 한 번만 npm에 닿으면 되고, 그 뒤로는 아무것도 필요 없습니다.
호스트 설정에서 연결을 풀고, npm 패키지를 지우고, ~/.mojulo/와 위의 두 캐시를 삭제하세요. 직접 설치한 엔진과 워커는 남기든 지우든 당신의 몫입니다.