はじめるapi キー不要 · アカウント不要

Mojulo 工房のインストールをエージェントに頼む方法。

mojulo はご自身でインストールしません。すでにお使いのコーディングエージェント — Claude Code、Codex、その他 MCP に対応したエージェント — にプロンプトを1つ貼れば、各ステップの前に確認しながらインストールを行います。あとは小さなものを1つ頼むだけ。返ってくるものは レシピとして保管されます。それをそのまま作り直す小さなファイルで、チャットより長く残ります。API キーもアカウントもテレメトリもなく、作ったものはご自身のマシンに残ります。

npx mojulo init
必要環境·node 22.12+·apache‑2.0·ローカルで動作·アカウント不要

4つのステップインストール · 把握 · 生成 · 編集

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 を配線し (ホストごとに yes/no を1回)、localhost:3001 に
   ダッシュボードを開きます。すべては私のマシンに留まります。
4. 終わったら、新しいセッションを開いて次のように聞くよう私に伝えてください:
   「これは何ですか?」

私に断りなく何かをインストールすることは、絶対にしないでください。

入ってくるもの: パッケージとそのネイティブランタイム — ディスク上で約 985 MB、1台のマシンで計測 — と、初回起動時に約 130 MB の検索モデル。3D レンダリングライブラリは既定のインストールに含まれます。含まれない唯一のものは、ファクトリーが静止画をベイクするのに使うヘッドレスブラウザです。これはベイクが必要になった最初のときに取得され(約 0.5 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> でそのどれでも実行できます。エージェントは要りません。

2

エージェントに、今何が見えているか聞く

新しいエージェントセッションを開き — 新しい配線は起動時に読み込まれます — 一行入力します。Mojulo は自身のルーティングインデックスを読み、声に出して自分の位置を確かめます。プロバイダーキーもクラウド呼び出しもなく、まだ何も作られていません。

これは何ですか?

forward_context — ファクトリーが自らを説明します。これが意図されたインターフェースです。あなたが頼み、エージェントが適切なツールを見つけて手を伸ばします。

3

小さなものを1つ頼む

次に、あなた自身のものを頼みます。エージェントがそれを書き、mojulo が小さな決定論的レシピとして保管し、開くための URL を渡します。

実寸センチメートルでコーヒーマグを作って、周回して見られるように   → mint_solid

保管される成果物はレシピです — 開くたびに同じマグカップを再生成する、読める数行。レンダリングは派生物で使い捨てです。レシピはディスクに残り、来週また手に取れます。

3D ツールが拒否して mojulo install creative を指名したら、それを実行してください。レンダリングライブラリは既定のインストールに含まれますが、npm install --omit=optional やネイティブビルドの失敗で欠けることがあります。拒否はそれを黙って失敗させずに知らせます。

4

そして変える

「もっと背を高く。」「色味を変えて。」エージェントが同じレシピの数行をその場で編集し、再レンダリングされます。ブラックボックスから作り直されるものは何もなく、変わった行はそのまま読めます。

取っ手をもっと太く、釉薬をマットな黒に   → update_sketch

マグカップは下限であって上限ではありません。ファクトリーが他に何を作るのか、そして仕上がったものが次にどこへ行けるのかは、何かを手にしたとき、あるいは尋ねたときに工房が教えます。このページは意図してここで約束をやめます。

最初の飛行頼む → 生成 → 見る → 残す

これは実際の物体が実際にどう作られたかで、最初の試みが間違っていた部分も含みます。その修正は手法の失敗ではありません。それこそが手法です。

あなた
実寸のハリケーンランタンを、3D で周回できるように作って
エージェント
生成中 — 積み重ねた旋盤プロファイル7枚と、スイープの取っ手1本: 真鍮、銅、ガラス、高さ 40 cm。/sketches/sk_jon77cn4ud を開いて周回してみてください。
あなた
取っ手が浮いている
エージェント
確かに — 取っ手の輪の両端が 3.6 cm のカラーの上、±6.5 cm の位置にあります。スイープを座り直しています… v2 を生成しました。輪がカラーに載ります。
あなた
これを残す

mint_solid — 頼みは普通の言葉で、物と大きさだけ。座標を打った人はいません。パーツは宣言された関係(on / gap / radial)で配置され、ファクトリーがそれを解きます。

保管されるのはレシピです — 1.8 KB のプロファイルとパス1本。周回して見るランタンは、レンダリングのたびにそこから導かれ、レンダリングは使い捨てです。

「取っ手が浮いている」は目のゲートです — 何かを残す前に、実際に人が見ます。レシピのおかげで見落としは安く済みました。パス1本を編集し、v2 を生成し、両方のバージョンがレシピとして残り、差分を取れます。

そして「これを残す」の後には、扉があります — 残したものは持ち出せます。プリンター用のファイル、ホストできるページ、それより大きな部屋。前もって並べ立てる人はいません。工房は、あなたが手にしているものに合う扉を、手にしたその瞬間に教えます。扉の先はすでにお使いのツール — blender、ゲームエンジン、スライサー — で、それらがすでに読めるファイルとして開き、そこで磨いたものは戻ってきて同じレシピに結び付けられます。

技術要件必要なもの · 容量 · 任意のもの

mojulo がマシンに求めるものの短縮版です。すべての数値は1台のマシンで、明記した日付に計測したものです。依存関係ごとのサイズまで載せた完全版はリポジトリにあります。

動かすために

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 でベイクします。推論ループはあなたのエージェントです。キーが必要になるのは、何かを描画しなければならないときだけです。

ディスク上

tarball 36 MBnpx mojulo init 後のディスク使用量 約 985 MB — 2026-09-11 に mojulo 2.0.2、macOS arm64 で計測。3D レンダリングライブラリはこの数値に含まれます。npm install --omit=optional で外せ(約 86 MB)、mojulo install creative で戻せます。

約 130 MB の検索モデル。初回起動時に一度だけ ~/.mojulo/models/ に取得されます。

レシピ1つにつき数キロバイト。 作ったものはすべて ~/.mojulo/data/ 配下の SQLite ファイル1つに入ります。

必要なときだけ後から取得

約 500 MB のヘッドレス Chrome。ベイクが最初に必要としたときに取得 — Chrome、Chromium、Edge、Brave がすでにマシンにあればスキップされます。

約 19 MB の ffmpeg。クリップを最初に MP4 へつなぐときに取得 — ffmpeg がすでに PATH にあればスキップされます。

インストール時には何もダウンロードしません。この2つは ~/.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 の横にヘッドレスの印刷検査を記録します。ファイル自体はどのスライサーでも開けます。

どれもインストールしていなくても、すべての書き出しは動作します。パックと手順付きのインポートガイドはいずれにせよ書き出され、マシン検査は理由とともに「skipped」を報告します。エンジンは数ギガバイト規模のインストールで、それぞれ独自のライセンスの下にあります。mojulo がエンジンをダウンロードしたり設定したりすることはありません。

任意のワーカー

ご自身で動かす別個のインストールです。mojulo がそれらを起動したり依存したりすることはなく、なければ1つのループが止まるだけで何も壊れません。ComfyUI と Qwen-Image-Edit はエージェントが描けないときに描画します — 約 31 GB、Apple Silicon では約 17 GB の量子化版。Kokoro はナレーションを読み上げます — 約 92 MB。TripoSR はグレーボックスの上に表面のディテールを彫り込みます — 約 1.4 GB。

ネットワーク

テレメトリなし。 外向きの通信は明示的な操作のときだけ発生します。npm によるパッケージの取得、上記の一度きりのダウンロード、エージェントが呼び出したときの check_for_updates、そしてエージェント自身のプロバイダーが行う通信 — これはエージェントの通信であって、mojulo のものではありません。

取り除くには

ホストの設定から接続を外し、npm パッケージを削除し、~/.mojulo/ と上記2つのキャッシュを削除します。ご自身でインストールしたエンジンとワーカーはあなたのものなので、残すも消すも自由です。