시작하기api 키 불필요 · 계정 불필요

에이전트에게 Mojulo 공방 설치를 요청하는 방법.

mojulo는 직접 설치하지 않습니다. 이미 쓰고 있는 코딩 에이전트 — Claude Code, Codex, MCP를 지원하는 모든 에이전트 — 에 프롬프트 하나를 붙여 넣으면, 각 단계마다 물어보면서 에이전트가 설치를 합니다. 그다음 작은 것 하나를 요청하세요. 돌아오는 것은 레시피로 보관됩니다 — 그것을 똑같이 다시 만들어내고, 대화보다 오래 남는 작은 파일입니다. API 키도, 계정도, 텔레메트리도 없습니다. 만든 것은 내 컴퓨터에 남습니다.

npx mojulo init
필요·node 22.12+·apache‑2.0·로컬에서 실행·계정 불필요

네 단계설치 · 파악 · 생성 · 수정

1

이것을 에이전트에 붙여 넣으세요

직접 아무것도 설치하지 마세요 — 이미 쓰고 있는 에이전트에 그 일을 넘기면 됩니다. 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. 끝나면 새 세션을 열고 네게 이렇게 물으라고 말해줘:
   "이게 뭐야?"

먼저 나에게 묻지 않고는 아무것도 설치하지 마.

내려오는 것: 패키지와 그 네이티브 런타임 — 한 대의 컴퓨터에서 측정한 디스크 기준 약 985 MB — 그리고 첫 실행 때 받는 ~130 MB 검색 모델입니다. 3D 렌더 라이브러리는 기본 설치에 들어 있습니다. 하나 빠져 있는 것은 팩토리가 정지 이미지를 베이크할 때 쓰는 헤드리스 브라우저인데, 베이크가 처음 그것을 필요로 할 때 가져오고(약 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>은 그중 무엇이든 실행합니다. 에이전트는 관여하지 않습니다.

2

에이전트에게 지금 무엇을 보고 있는지 물어보세요

새 에이전트 세션을 열고 — 새 연결은 시작할 때 인식됩니다 — 한 줄을 입력하세요. mojulo가 자신의 라우팅 인덱스를 읽고 소리 내어 스스로를 파악합니다 — 프로바이더 키도, 클라우드 호출도 없고, 아직 만든 것도 없습니다.

이게 뭐야?

forward_context — 팩토리가 스스로를 설명하는 것입니다. 이것이 의도된 인터페이스입니다: 당신이 묻고, 에이전트가 맞는 도구를 찾아 그것에 손을 뻗습니다.

3

작은 것 하나를 요청하세요

그다음엔 당신 것을 요청하세요. 에이전트가 그것을 작성하고, mojulo가 작고 결정론적인 레시피로 보관하며, 열어 볼 URL을 건네줍니다.

돌려볼 수 있는 실제 센티미터 단위 커피 머그컵을 만들어줘   → mint_solid

저장되는 산출물은 레시피입니다 — 열 때마다 같은 머그컵을 다시 생성하는, 읽을 수 있는 몇 줄입니다. 렌더는 파생물이고 버려도 됩니다. 레시피는 디스크에 남아 다음 주에 다시 집어 들 수 있습니다.

3D 도구가 거부하면서 mojulo install creative를 언급하면, 그것을 실행하세요. 렌더 라이브러리는 기본 설치에 들어 있지만, npm install --omit=optional이나 실패한 네이티브 빌드가 그것을 빠뜨릴 수 있습니다 — 그리고 그럴 때는 조용히 실패하는 대신 거부하면서 그렇다고 말합니다.

4

그다음 바꿔 보세요

"더 높게 만들어줘." "색조를 바꿔줘." 에이전트가 같은 레시피의 몇 줄을 그 자리에서 고치면 다시 렌더됩니다. 블랙박스에서 다시 생성되는 것은 없고, 바뀐 줄은 읽어 볼 수 있게 그대로 있습니다.

손잡이를 더 두껍게, 유약은 무광 검정으로   → 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과 다른 호스트는 선언된 프로파일로 연결됩니다.

데스크톱 OS. macOS, Apple Silicon에서 빌드하고 검증했습니다. Linux: 테스트 스위트는 CI의 Ubuntu에서 실행되며, 2.0.1의 새 설치를 Linux x64와 arm64에서 확인했습니다. 아래의 엔진 확인 항목은 거기서 검증되지 않았습니다. Windows: 네이티브 Windows 머신에서 Claude Code로 검증했습니다 — npx mojulo init이 완료되고 첫 렌더가 나왔습니다. 그곳의 Codex와 아래의 엔진 확인 항목은 확인하지 않았습니다.

GPU 불필요, 프로바이더 키 불필요, 계정 불필요. 정지 이미지는 CPU에서 베이크됩니다. 추론 루프는 당신의 에이전트입니다. 키는 무언가를 그려야 할 때만 등장합니다.

디스크 사용량

36 MB tarball, npx mojulo init 이후 디스크 ~985 MB — macOS arm64에서 mojulo 2.0.2를 대상으로 2026-09-11에 측정했습니다. 3D 렌더 라이브러리는 그 수치 안에 있습니다. npm install --omit=optional은 그것을 덜어내고(~86 MB), mojulo install creative가 되돌려 놓습니다.

~130 MB 검색 모델, 첫 실행 때 한 번 ~/.mojulo/models/로 받습니다.

레시피당 킬로바이트. 만든 모든 것은 ~/.mojulo/data/ 아래 하나의 SQLite 파일입니다.

필요할 때만 나중에 받음

~500 MB 헤드리스 Chrome, 베이크가 처음 그것을 필요로 할 때 — 컴퓨터에 Chrome, Chromium, Edge, Brave가 이미 있으면 건너뜁니다.

~19 MB ffmpeg, 클립을 처음 MP4로 이어 붙일 때 — ffmpeg가 이미 PATH에 있으면 건너뜁니다.

설치 시점에는 아무것도 다운로드하지 않습니다. 이 두 개는 ~/.mojulo/가 아니라 패키지 디렉터리 안에 캐시됩니다. 전체 시트가 그 위치를 바꾸는 변수들을 알려줍니다.

선택 · 당신이 설치하고, mojulo가 감지

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는 그중 어느 것도 다운로드하거나 설정하지 않습니다.

선택 워커

당신이 직접 실행하는 별도 설치입니다. mojulo는 그것을 시작하지도, 그것에 의존하지도 않으며, 없으면 루프 하나가 꺼질 뿐 아무것도 깨지지 않습니다. ComfyUI와 Qwen-Image-Edit는 에이전트가 그릴 수 없을 때 그립니다 — ~31 GB, Apple Silicon에서는 ~17 GB 양자화 버전. Kokoro는 내레이션을 읽습니다 — ~92 MB. TripoSR는 그레이박스 위에 표면 디테일을 조형합니다 — ~1.4 GB.

네트워크

텔레메트리 없음. 외부로 나가는 트래픽은 명시적인 동작에서만 발생합니다: npm이 패키지를 가져올 때, 위의 일회성 다운로드, 에이전트가 check_for_updates를 호출할 때, 그리고 에이전트 자신의 프로바이더가 하는 일 — 그 트래픽은 에이전트의 것이고 mojulo의 것이 아닙니다.

제거하려면

호스트 설정에서 연결을 풀고, npm 패키지를 지우고, ~/.mojulo/와 위의 두 캐시를 삭제하세요. 직접 설치한 엔진과 워커는 남기든 지우든 당신의 몫입니다.