开始使用无需 api 密钥 · 无需账户
如何让您的智能体安装 Mojulo 工坊。
mojulo 不用您亲自安装。您把一段提示词粘贴进已在运行的编程智能体——Claude Code、Codex,或任何支持 MCP 的智能体——由它完成安装,每一步都先征求同意。然后向它要一件小东西。返回的结果会作为配方保存——一个能精确重做它、并且比聊天记录活得更久的小文件。无需 API 密钥、无需账户、无遥测;您做出的东西留在您的机器上。
npx mojulo init
四步安装 · 定向 · 铸造 · 编辑
把这段粘贴进您的智能体
什么都不用您亲自安装——把活交给您已在运行的智能体。打开 Claude Code 或 Codex,粘贴这段提示词。它会先检查机器,报告发现的情况,并在安装任何东西之前征求您的许可——没有您点头,什么都不会进入您的机器。
帮我安装 mojulo——一座免费的本地 3D 工厂,你将通过 MCP 驱动它。 定向资料,如果你能获取的话: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 渲染库包含在默认安装中。唯一不包含的是工厂用来烘焙静态图片的无头浏览器:它在第一次烘焙需要时才获取(约半 GB),安装时绝不下载,且机器上已有的 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> 运行其中任意一个,无需智能体参与。
问问您的智能体它看到了什么
打开一个新的智能体会话——新的接线在启动时被读取——然后输入一行。Mojulo 读取自己的路由索引,并把定向过程说出来——无需服务商密钥,没有云端调用,还没有构建任何东西。
这是什么?
forward_context——工厂在解释自己。这就是预期的交互方式:您提问,您的智能体找到合适的工具并伸手去用。
要一件小东西
然后要一件属于您自己的东西。您的智能体编写它,mojulo 把它保存为一份小而确定的配方,并交给您一个可打开的 URL。
做一个真实厘米尺寸、可以环绕观察的咖啡杯 → mint_solid
配方才是被存储的产物——几行可读的文字,每次打开都重新生成同一只杯子。渲染是派生的、可丢弃的;配方留在您的磁盘上,下周可以再接着用。
如果某个 3D 工具拒绝执行并提到 mojulo install creative,就运行它。渲染库随默认安装提供,但 npm install --omit=optional 或一次失败的原生构建可能会漏掉它们——拒绝时会明说,而不是悄悄失败。
然后改它
“做高一点。”“换个色调。”您的智能体就地编辑同一配方里的几行,它随即重新渲染;没有任何东西是从黑箱里重新生成的,它改过的那几行就摆在那里供您阅读。
把把手加粗,釉面改成哑光黑 → update_sketch
杯子是下限,不是上限。工厂还能做什么——以及完成的东西接下来能去哪里——工坊会在您手里有了东西时、或在您问起时告诉您。这个页面有意在此停止承诺。
首次飞行要 → 铸造 → 看 → 留下
这是一件真实物体实际被做出来的过程,包括第一次尝试出错的那一段。修正不是方法的失败;修正就是方法。
做一盏真实尺寸、可以在 3D 里环绕观察的防风煤油灯
铸造中 — 七个叠放的车削轮廓和一个扫掠而成的提手:黄铜、紫铜、玻璃,高 40 cm。打开 /sketches/sk_jon77cn4ud 环绕观察。
提手是悬空的
确实 — 提环两端落在 ±6.5 cm 处,而颈圈只有 3.6 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 和其他宿主按声明的配置接入。
桌面操作系统。在 macOS、Apple Silicon 上构建并验证。Linux:测试套件在 CI 的 Ubuntu 上运行,2.0.1 的全新安装在 Linux x64 和 arm64 上验证过;下文的引擎检查未在其上验证。Windows:在原生 Windows 机器上用 Claude Code 验证过 —— npx mojulo init 完成,并渲染出第一张图;该平台上的 Codex 与下文的引擎检查尚未验证。
无需 GPU、无需服务商密钥、无需账户。静态图片在 CPU 上烘焙。您的智能体就是推理循环;只有在需要绘画时才会用到密钥。
tar 包 36 MB,磁盘占用 ~985 MB(npx mojulo init 之后)——2026-09-11 在 macOS arm64 上针对 mojulo 2.0.2 实测。3D 渲染库已计入该数字;npm install --omit=optional 会去掉它们(~86 MB),mojulo install creative 再把它们装回来。
~130 MB 搜索模型,首次启动时获取一次,存入 ~/.mojulo/models/。
每份配方仅几 KB。您做的一切都在 ~/.mojulo/data/ 下的一个 SQLite 文件里。
~500 MB 无头 Chrome,在第一次烘焙需要时——机器上已有 Chrome、Chromium、Edge 或 Brave 时跳过。
~19 MB ffmpeg,在第一次把片段拼接成 MP4 时——ffmpeg 已在您的 PATH 中时跳过。
安装时不下载任何东西。这两项缓存在软件包目录内,而不是 ~/.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 旁边盖上一份无头打印检查;任何切片软件都能打开该文件。
这些一个都不装,每种导出也照样可用:包及其分步导入指南无论如何都会写出,机器检查会报告“已跳过”并给出原因。这些引擎是数 GB 的安装、各有自己的许可;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/ 和上述两处缓存。您自己安装的引擎和工作器,留或删都由您决定。