Open Source Robotics

高品質なオープンソースロボティクスプロジェクト、ツール、ソフトウェアの厳選コレクション。

text-to-cad

AI コーディングエージェントに Python の CAD で部品を設計させ、ロボットを MuJoCo に書き出す

ライセンス

MIT

コードと skills:MIT。earthtojake/text-to-cad の LICENSE ファイルと、各 skill フォルダーの LICENSE ファイルで確認しました(著作権者 Thompson Labs LLC)。エージェントアプリ:text-to-cad には別の AI エージェントアプリが必要で、そのアプリ独自の条件が適用されます。サービス:SendCutSend と Bambu Lab は独自の条件を持つ第三者のサービスです。skills はファイルを確認・準備するだけで、注文はしません。テレメトリー:オフにしない限り、利用回数とクラッシュレポートが api.texttocad.dev に送られます。モデル、プロンプト、ファイルパスは送られません。カード画像:プロジェクト自身の SNS プレビュー画像を切り抜いたもので、コードのライセンスの対象外です。2026-11-13 に LICENSE ファイル、README、プライバシーポリシーで確認しました。

概要

text-to-cad は、Claude Code、Codex、Cursor、Gemini CLI などの AI コーディングエージェントに実物の部品やアセンブリを設計させるオープンソースのプラグインです。エージェントは各モデルを OpenCASCADE カーネル上の build123d ライブラリを使った Python スクリプトとして書き、実行して、結果をローカルの CAD ビューアに表示します。モデルは STEP、STL、3MF、GLB、DXF の各ファイルに書き出せます。ほかの skills は、部品が切削加工、切断と曲げ加工、射出成形、3D プリントで作れるかを確認し、CalculiX で強度を確認し、寸法入りの PDF 図面を描き、Blender で画像をレンダリングし、KiCad で基板を設計し、OrcaSlicer でプリントをスライスし、SendCutSend の注文ガイドに照らしてファイルを確認します。ロボット向けには、モデルの関節と材料から URDF、SRDF、MJCF のロボット記述を書き出し、2026年11月の 0.11.8 リリースからは MuJoCo 4 に対応しています。質量と慣性は CAD から求め、チェックが MuJoCo でモデルをコンパイルし、ロボットとシーンは Python で組み立てます。作者は earthtojake で、MIT ライセンスのもと、すべてユーザー自身のコンピューターで動きます。

text-to-cad は、エージェント用の skills と、コーディングエージェントが MCP 経由で呼び出すローカルの CAD サーバーからなります。インストールスクリプトは見つけたすべてのエージェントアプリに設定を行います。Claude Code、Claude Desktop、Codex、Cursor、Grok Build、Gemini CLI にはプラグインが入り、GitHub Copilot、Windsurf、Cline、Zed など約十五のエージェントには skills だけが入ります。ツール本体は Python パッケージの cad で、uv から実行します。プロジェクトのサイトは texttocad.dev です。

モデルは OpenCASCADE カーネル上で build123d を使って書く Python スクリプトです。CAD skill はエージェントにそれを実行させ、CAD ビューアに表示し、STEP、STL、3MF、GLB、あるいはレーザー切断やウォータージェット切断用の DXF 輪郭と展開図として書き出させます。アセンブリには関節とアニメーションを持たせられます。ほかの skills は、切削加工、板金、射出成形、3D プリントの製造性チェック、線形静的強度チェック(CalculiX による有限要素法)、PDF の技術図面、Blender によるレンダリング、KiCad の基板、OrcaSlicer によるスライスと Bambu Lab のプリンターへの送信、そしてSendCutSend の注文前チェックを扱います。

ロボットシミュレーション skill は、モデルの関節、材料、名前付き座標系を、ROS 2 用の URDF、MoveIt 用の SRDF、MuJoCo 用の MJCF に変換します。2026年11月11日の 0.11.8 リリースで MuJoCo 4.0.0 への対応が加わりました。

- 各リンクの質量、重心、慣性は CAD カーネルを通じて部品の材料から求め、一つのコマンドでロボットを MJCF または URDF に書き出します。 - 普通の Python 関数が MuJoCo 自身の spec 上でシミュレーションの選択を行います。プリミティブに当てはめた衝突形状や、CoACD で凸包に分けた形状(凸分解)、関節の減衰、アクチュエータ、センサーです。 - cad mujoco check コマンドは MuJoCo でファイルをコンパイルし、静止時に食い込む部品、誤ったスケール、範囲外の関節、何が何と衝突するかを報告します。 - シーンは Python で組み立てます。たとえば CAD で設計したグリッパーを別の出どころのアームに取り付け、つかむためのブロックを置く、といった形で、ブラウザの MuJoCo Studio で開けます。 - ranges コマンドは、各関節を部品同士が触れるまで動かして可動域の端を見つけます。

MuJoCo サンプルプロジェクトは、SO-101 アームと Trossen WidowX AI のメーカー製 STEP ファイルをこの手順に通し、結果を MuJoCo Menagerie の手作りモデルと比べています。総質量の差は 1.3% と 2.7% です。プロジェクトはこれをベンチマークではなくサンプルと呼んでいます。

重要な理由

多くのロボットは CAD 上の部品から始まりますが、その部品からシミュレーションモデルを作るには、たいてい商用 CAD ソフトと、onshape-to-robot のような別の変換ツールが必要です。text-to-cad はその流れ全体を、AI エージェントが書き人が読めるコードとして保ちます。部品、アセンブリ、関節、質量、MuJoCo モデルがすべて同じ Python スクリプトから生まれるので、設計変更は一度の編集と再実行で済みます。MuJoCo 対応はおもちゃの例ではなく、実在のロボットである SO-101 と WidowX AI で確かめられています。SolidCraft と同じく、まずは汎用の CAD です。ロボット機能は八つの skills のうちの一つで、すでにコーディングエージェントを使っている人に向いています。

解決する課題

ロボットの部品を設計し、それを含むロボットをシミュレーションするには、ふつう CAD ソフト、質量と慣性を正しくする手作業、そして変更のたびに実行し直す URDF や MJCF への変換ツールが必要です。text-to-cad では、AI エージェントが部品を Python スクリプトとして書き、製造性を確認し、同じスクリプトからロボット記述と MuJoCo のシーンを生成します。物理特性は CAD から取ります。

主なポイント

  • AI コーディングエージェントが部品とアセンブリを build123d の Python スクリプトとして書くためのプラグインと skills
  • STEP、STL、3MF、GLB、DXF を書き出し、切削加工、板金、射出成形、3D プリントの製造性を確認
  • モデルの関節と材料から URDF、SRDF、MJCF を書き出し、質量と慣性は CAD から求める
  • 0.11.8 リリースから MuJoCo 4 に対応:MuJoCo 関数、モデルのチェック、Python で組み立てるシーン
  • CalculiX による強度チェック、PDF 図面、Blender のレンダリング、KiCad の基板にも対応
  • MIT ライセンス。アカウント不要でローカルで動き、オフにしない限り利用統計を送信

対象

  • すでに AI コーディングエージェントを使っていて、プリント部品や切削部品を設計させたいロボット製作者
  • CAD を持っているロボットの MuJoCo モデルや URDF モデルが必要な研究者
  • 注文前に部品を 3D プリントや板金向けに確認したいメイカー
  • ハードウェア設計をコードとしてバージョン管理したい開発者

制限事項

  • Claude Code、Codex、Cursor などの AI エージェントアプリが必要。これらは別製品で、それぞれ独自の条件と費用がある
  • まずは汎用の CAD。ロボット機能は八つの skills の一つで、MuJoCo 対応は 2026年11月に加わったばかり
  • 通常の MJCF 書き出しにはアクチュエータ、関節の動力学、選んだ衝突形状が入らない。これらは MuJoCo 関数で手書きする
  • MuJoCo のサンプルはベンチマークではない。アクチュエータのゲインはロボットが姿勢を保つように選んだもので、測定値ではない
  • シーンを見るための MuJoCo Studio は、認証なしですべてのネットワークインターフェースで待ち受ける
  • CoACD による凸分解は Intel Mac、Windows on ARM、musl Linux では使えない
  • 強度チェックは線形の静的荷重のみ
  • インストールはスクリプトをパイプでシェルに渡して実行し、約 240 MB の CAD カーネルをダウンロードする
  • 利用統計とクラッシュレポートは既定で送信される。オフにできる
  • ほぼ一人のメンテナーによる開発で、数日おきにリリースがある

このウェブサイトにはJavaScriptが必要です。オープンソースロボティクスプロジェクトを閲覧するにはJavaScriptを有効にしてください。