コードで設計する、木組みと木工のための CAD
Kumiki は、木組みと木工のためのオープンソース Python ライブラリです。設計はただのプログラムで、どの継手も、つなぐ材に合わせてパラメトリックに寸法が決まります。すべてがコードでできているので、Kumiki の架構は AI エージェントの手を借りて設計できます。
Kigumi 0.9.11:Mac(Apple シリコン)、Mac(Intel)、Windows、または VS Code 拡張機能。無料のオープンソースです。
tinyhouse120.pyしくみ
Kumiki で作ったもの
架構、継手、そして完成した小屋。そのもとになったパターンは Kumiki に付属しています。
エージェントと設計する
架構は正確な寸法を持つただの Python なので、コーディングエージェントが説明から架構を書き、ビルドし、できたものを見て確かめられます。
Kigumi のエージェント
Kigumi アプリとブラウザ版にあるエージェントパネルは、架構のファイルを編集し、ビルドできるか確かめ、ビューを見て確認します。Kigumi のアカウントでサインインするか、自分の OpenRouter キーを使います。
自分のエージェント
Claude Code や Codex なども架構を書けます。設計の手引き(英語)を渡し、アプリで Kigumi の MCP サーバーを有効にすれば、架構をビルドして見られるようになります。
かわいい馬(作業台)を作って。1′×2′ の範囲に水平な足が 2 本あって、その上に垂直な脚が 2 本立ち、2 本の脚の上に水平な梁が載っている。2 本の脚の真ん中を貫でつないでほしい。全部、角の込み栓を打った枘でつないでね!
よくある質問
Kumiki とは何ですか?
Kumiki は、木組みの架構、軸組の建物、木工の継手・仕口をコードで設計するためのオープンソース Python ライブラリです。対になる Kigumi が、書いたそばから架構を 3D で表示し、継手の X 線表示、CSG ツリー、図面、ライブパラメータ(木割り)を備えています。
Kigumi とは何で、どこで動きますか?
Kigumi は Kumiki のビューア兼エディタです。架構のスクリプトを実行して 3D で描画します。Mac と Windows のデスクトップアプリ、VS Code と Cursor の拡張機能、またはブラウザ(kumiki.build/try)で使えます。アプリとブラウザ版にはエージェントも組み込まれています。
木工用途で、OpenSCAD、CadQuery、FreeCAD と比べてどうですか?
汎用 CAD は、あくまで汎用です。継手は描くのが難しく、使い回しもしにくい。Kumiki は分野に特化した CAD です。継手・仕口(枘、蟻、継手、相欠き、鎌継ぎ、大入れ、込み栓)は専用の関数で作られ、つなぐ部材がどんな形でも継手の形を合わせます。また FreeCAD と違い、設計はすべてコードで書くので、エージェントによる設計に最も向いています。
AI エージェント(Claude、Codex、Cursor、Copilot)を使って Kumiki で架構を設計できますか?
はい。架構は正確な寸法を持つただの Python で、エージェントが得意とするものです。Kigumi のプロジェクトには設計の手引きと基本概念のドキュメントが含まれ、エージェントが自動で見つけます。Kigumi の MCP サーバーを使えば、いつものエージェントが架構をビルドし、アプリで見られます。
どんな継手・仕口に対応していますか?
伝統的なものから現代的なものまで 30 種類以上の継手・仕口があり、それぞれにパラメトリックなバリエーションがあります。枘(角枘、大入れ、通し、楔、込み栓、引き寄せ)、相欠き(隅、十字、留め、片側隠し)、蟻(標準、楔付き片蟻、蟻落し)、継手(雇い枘、腰掛鎌継ぎ、金輪継ぎ)、垂木の組手、大入れの根太掛けなど。
3D モデルや加工用のファイルを書き出せますか?
はい。架構や個々の材を、レンダリングや 3D プリント向けに STL、OBJ、3MF で、CNC やほかの CAD 向けに STEP で書き出せます。図面は PNG で書き出せ、SVG にも近く対応予定です。
枘ひとつから始めて、納屋まで
Kumiki はライブラリ、Kigumi は Kumiki の架構を作るための設計アプリと環境です。インストールは簡単で、セットアップは自動です。