开始使用无需 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无头 · 出口:artifact 工具
已运行 · 2026-09-21
open a linux box and install mojulo npm package in it
那句话就是整个安装:智能体打开自己的沙盒,无需键盘地运行 init --yes,然后报告。2026-09-21,一个 Claude Code 网页会话就是这样做的:铸造了一部真实尺寸的 47 零件手机,并把 glTF 交了回来;artifact 工具就是出口,一次一个自包含页面。
ChatGPT已连接的 MCP,或工作模式下无头 · 出口:报告
已运行 · 2026-09-22
on work mode, open a linux box and install mojulo npm package in it
ChatGPT 在打开沙盒之前会先问您——点接受。2026-09-22,在工作模式(work mode)下,它安装了 mojulo、完成接入、访问到了回环控制台,并铸造了一件无需密钥的东西。在工作模式之外,它的沙盒没有互联网,所以那里什么也没装上——沙盒的出网是套餐的规则,不是 mojulo 的。从这个沙盒往外交出文件尚未运行过;回复里的配方就是出口。如果已经连接了 mojulo MCP 服务器,ChatGPT 会改用它;ChatGPT 指南两种情况都涵盖。
Grok chat无头 · 仅 shell · 出口:文件卡片
已运行 · 2026-09-21
open a linux box and install mojulo npm package in it
Grok chat 的沙盒有 shell 而没有 MCP 客户端,所以安装之后它从命令行驱动同一个注册表——npx mojulo call <tool>。2026-09-21,它用这种方式铸造了一座城市并导出;文件卡片就是出口,world.html 无需服务器即可从磁盘打开。这里说的是 Grok chat,不是 Grok Build——那个 CLI 是您自己机器上真正的 MCP 宿主,用下面的本地提示词。
Meta Muse无头 · 持久虚拟机 · 仅 CLI · 出口:Artifacts 和 Library
已运行 · 2026-09-23
open a linux box and install mojulo npm package in it
Muse 在其所有客户端背后驱动同一台持久的 Linux 虚拟机,它有 shell 而没有 MCP 客户端,所以从命令行运行 mojulo——npx mojulo call <tool>,从 npx mojulo orient 开始。与其他沙盒不同,这台虚拟机在对话之间保留 ~/.mojulo/。页面经由它的 Artifacts 工具送出,文件经由它的 Library 送出。
在您自己的机器上。打开 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. 完成后,告诉我打开一个新会话并问你: “这是什么?” 不先问过我,绝不在我的机器上安装任何东西。
两个地方下载的都是:一个 6.7 MB 的软件包,连同依赖落到磁盘上约 227 MB,在一台机器上实测,且不含模型——在您选择加入 mojulo install recall 之前,搜索按您请求中的词语排序。控制台是单独的软件包,只在您打开它时才获取。用来烘焙静态图片的浏览器不在安装之中:显式渲染在第一次需要时才获取一个(约半 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> 运行其中任意一个,无需智能体参与。Grok chat 的沙盒正是通过这条 shell 路线运行它的。当 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 版本已无人维护,并存在已知的安全问题。步骤见从 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 环绕观察。
提手是悬空的
确实 — 提环两端落在 ±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 宿主,或一个 shell。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)、工作模式下的 ChatGPT(2026-09-22)、仅有 shell 的 Grok chat 沙盒(2026-09-21)以及仅有 shell 的 Meta Muse 持久虚拟机(2026-09-23)上运行过。Codex 云端任务:按其文档,默认关闭互联网。Blender 能装进这些沙盒;切片软件和游戏引擎装不了,而导出包无论如何都会写出。
无需 GPU、无需服务商密钥、无需账户。静态图片在 CPU 上烘焙。您的智能体就是推理循环;只有在需要绘画时才会用到密钥。
6.7 MB tar 包,解包后 21.3 MB,连同依赖安装后 ~227 MB(153 个软件包)——2026-09-30 在 macOS arm64 上针对 mojulo 3.0.0 实测。冷启动下载约 79 MB,在 npm 缓存中留下约 140 MB,并通过本地注册表替身在中位 4.5 s 内响应 initialize;真实的注册表更慢。创作辅助组件(音频、精确布尔运算、图像)已计入该数字;npm install --omit=optional 会去掉其中约 115 MB。控制台 mojulo-ui 打包后 12.7 MB、解包后 57.0 MB,只在您打开它时才获取。
不含模型。默认安装不获取任何模型;搜索照样回答,按您请求中的词语排序。嵌入模型是下面的可选项。
每份配方仅几 KB。您做的一切都在 ~/.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 的模型,升级时保留。大多数会话从不需要它;智能体直接读取工具索引。
这些一个都不装,每种导出也照样可用:包及其分步导入指南无论如何都会写出,机器检查会报告“已跳过”并给出原因。这些引擎是数 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。软件保留的唯一日志,即它自己的工具调用记录,留在您的机器上;完整清单在代码仓库里。
在沙盒里,出网由宿主说了算。Codex 云端任务出厂即关闭互联网;ChatGPT 的沙盒在工作模式之外没有网络。Mojulo 只在安装时需要访问一次 npm,之后不再需要。
从宿主配置中解除接线,移除 npm 包,删除 ~/.mojulo/ 和上述两处缓存。您自己安装的引擎和工作器,留或删都由您决定。