コードで設計する、木組みと木工のための CAD

Kumiki は、木組みと木工のためのオープンソース Python ライブラリです。設計はただのプログラムで、どの継手も、つなぐ材に合わせてパラメトリックに寸法が決まります。すべてがコードでできているので、Kumiki の架構は AI エージェントの手を借りて設計できます。

Kigumi 0.9.11:Mac(Apple シリコン)、Mac(Intel)、Windows、または VS Code 拡張機能。無料のオープンソースです。

Kumiki で設計したタイニーハウスの架構
架構タイニーハウス
ソースtinyhouse120.py
継手・仕口蟻、枘、相欠き

しくみ

Python を書けば、架構ができる

架構の設計はパラメトリックなプログラム

材と継手・仕口は、Kumiki が用意する Python の関数で定義します。コードはすべてパラメトリックです。寸法をひとつ変えれば、それに関わる継手がすべて更新されます。コードはエージェントと一緒に書いても、手で書いてもかまいません。

  • 継手は関数:正確で、カスタマイズでき、ドキュメントがある
  • パターンは組み合わせられる:同じ方杖を各梁の下に使える
  • どんな AI エージェントとでも一緒に設計できる
架構の隅に留め相欠きと込み栓の継手を定義する Python のソース そのコードが作る小屋を Kigumi で表示したもの

ビューア

Kigumi は、書いたそばから架構を表示します

Kigumi は架構を実行して描画します。Mac と Windows のデスクトップアプリ、VS Code 拡張機能、ブラウザのどれでも動きます。材を選んで寸法を読み、継手の形状ツリーをたどり、レイヤーを隠し、断面を切り、寸法を測れます。

  • 面・辺・継手の要素ひとつまで形状を調べられる
  • レイヤー、タグ、部材ごとの表示切り替えで架構を分解して見られる
  • X 線表示と断面表示で継手を内側から読める
二連の馬(作業台)の X 線表示。材の中の継手が見える ビューアで表示したコーヒーテーブルの架構

ブーリアン演算ではなく、継手

材が変わっても正しく収まる、伝統的な継手・仕口

枘、蟻、相欠き、継手、楔や込み栓を使ったものまで。どれもパラメトリックな継手で、つなぐ材が動いたり、寸法が変わったり、別の角度で取り合ったりすると、自動で刻み直されます。

  • 大入れ、胴付き、逃げ、込み栓は材から導かれる
  • 複雑な設計向けの細かく設定できる継手と、直交する架構向けのシンプルな継手
  • 数十種類の継手があり、今も増え続けている
込み栓付きの片側隠し相欠き(十字)の X 線表示 斜めに取り合う、込み栓付きの方杖の枘差し

図面

架構そのものから作る、平面図と加工図

図面はモデルの投影なので、モデルとずれることがありません。Kumiki は材そのものから図面の配置を決めます。ビューポートや縮尺を自分で置く必要はありません。

  • 平面図と、部材の種類ごとの寸法入り図面
  • コードで生成・カスタマイズでき、図面も設計の一部になる
  • Kigumi で寸法を手で追加し、シートを PNG で書き出せる
生成されたシート:正面図、平面図、側面図、アイソメ図

作業の順序

継手から割り出す、架構の組み立て順

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 の架構を作るための設計アプリと環境です。インストールは簡単で、セットアップは自動です。