ghbalf/freecad-ai

FreeCAD AI – FreeCAD 内での AI 支援 3D モデリング

概要 – チャット形式のアシスタントを追加する FreeCAD ワークベンチです。自然言語のコマンド（例：「50 mm × 30 mm × 20 mm の箱を作って」）を入力すると、アシスタントは Python コードを生成するか、FreeCAD で要求された操作を実行する一連の定義済み「ツール」を呼び出します。結果はアクティブな FreeCAD ドキュメントに直接挿入されます。

主な機能

• チャット UI は FreeCAD 内にドッキングされ、サポートされている 22 の LLM プロバイダー（OpenAI、Anthropic、Ollama、Gemini など）から応答をストリーミングします。
• Plan と Act：Plan は生成されたコードを表示して確認できます。Act はコードを自動実行するか、望ましくは安全な undo トランザクションでラップされた構造化ツール呼び出しを実行できます。
• ツールライブラリ：50 個の組み込み FreeCAD 操作（プリミティブ、スケッチ、パッド、ポケット、ブール演算、フィレット、パターン、エクスポートなどの作成）に加え、ユーザーが独自の Python 関数を追加できるフックシステム。
• ビジョンサポート – チャットに添付された画像はビジョン対応モデルに送信されます。それ以外の場合はフォールバック MCP サーバーで処理されます。
• セッション管理 – チャットセッションの保存/読み込み、自動コンテキスト要約、プロバイダーが利用できない場合のフォールバックプロファイル。
• 外部依存ゼロ – このワークベンチは Python 標準ライブラリのみを使用します。

入手方法

1. FreeCAD 1.0+ をインストールします。
2. repo をクローンし、FreeCAD の Mod ディレクトリにシンボリックリンクを作成（またはコピー）します（パスは OS によって異なります。README を参照）。
3. FreeCAD を再起動すると、FreeCAD AI ワークベンチがセレクターに表示されます。
4. ワークベンチを開き、Edit → Preferences → FreeCAD AI または歯車アイコンの設定ダイアログで LLM プロバイダー（API キーまたはローカル Ollama）を設定し、チャットを開始します。

典型的なワークフロー

1. 説明を入力します。
2. Plan モードでは、生成された Python を確認し、Execute を押します（失敗した場合は Fix with AI）。
3. Act モードでは、モデルにツールを直接呼び出させてより安全にモデリングするか、生のコード実行にフォールバックします。
4. 組み込みツール（export_model、capture_viewport など）を使用するか、.py または .FCMacro ファイルでカスタムツールを追加します。

対象者 – FreeCAD を離れずに自然言語駆動のモデリングを試したい CAD デザイナー、ホビイスト、開発者。まだ alpha 段階です。クラッシュや破壊的変更が発生する可能性があるため、頻繁にバックアップを取ってください。