アルファソフトウェア — このプロジェクトはまだ初期開発段階です。粗削りな部分や壊れた変更、そしてLLM生成コードによるFreeCADのクラッシュが時折発生することを覚悟してください。使用には注意し、作業は頻繁に保存してください。

FreeCAD用のAI搭載アシスタントワークベンチで、Pythonコードを生成・実行し、自然言語の記述から3Dモデルを作成します。

特徴

• チャットインターフェース — ストリーミングLLM応答を備えたドックウィジェット
• 計画/行動モード — 実行前にコードをレビューする(計画)または自動実行(行動)
• ツール呼び出し — より安全で信頼性の高いモデリングのための50の構造化されたFreeCAD演算(Actモード)
• ツールの再ランク付け — オプションのキーワードまたはLLMベースのフィルターにより、1ターンあたり最も関連性の高い上位NのツールのみをLLMに送り、多数のツール+MCPサーバーが登録された場合にプロンプトトークンを節約します
• スキル — モデルが自律的にまたは/command(筐体、ギア、ファスナー穴、画像からのスケッチなど)を通じて呼び出す再利用可能な命令セット
• Skill optimizer — 反復的なテスト・評価・修正ループ([/optimize-skill)を通じてスキル指示を自動的に改善します
• Hooks — ライフサイクルイベント用のユーザー定義Pythonフック(ツールのブロック、入力の修正、アクティビティのログ、ファイル添付ファイルの変換)

FreeCAD AI

Alpha software — this project is in early development. Expect rough edges, breaking changes, and the occasional FreeCAD crash from LLM-generated code. Use with caution and save your work frequently.

An AI-powered assistant workbench for FreeCAD that generates and executes Python code to create 3D models from natural language descriptions.

Features

• Chat interface — dock widget with streaming LLM responses
• Plan / Act modes — review code before execution (Plan) or auto-execute (Act)
• Tool calling — 50 structured FreeCAD operations (Act mode) for safer, more reliable modeling
• Tool reranking — optional keyword or LLM-based filter sends only the top-N most relevant tools to the LLM per turn, saving prompt tokens when many tools + MCP servers are registered
• Skills — reusable instruction sets the model invokes autonomously or via /command (enclosure, gear, fastener holes, sketch-from-image, etc.)
• Skill optimizer — automatically improve skill instructions via iterative test-evaluate-modify loop (/optimize-skill)
• Hooks — user-defined Python hooks for lifecycle events (block tools, modify input, log activity, convert file attachments)
• User extension tools — register your own Python functions as LLM-callable tools (.py or .FCMacro)
• Vision routing — auto-detects LLM vision capability; non-vision models use MCP fallback via llm-vision-mcp, no-vision-path disables image controls
• File attachments — attach images, text files, and documents to chat messages (capture, attach, drag-drop, paste); extensible via file_attach hook for binary formats (PDF, DOCX) or MCP servers for rich conversion
• Image support — viewport screenshots and images sent as vision blocks; auto-detected binary format rejection (PDF, ZIP, Office docs)
• Thinking mode — enable LLM reasoning for complex multi-step tasks (Off / On / Extended)
• Context compacting — automatically summarizes older messages when approaching context limits
• Fallback profiles — when the chat model can’t be reached (Ollama box off, vendor 503, revoked key), the turn is tried once on each profile you list, in order, and a note says which one answered
• Session resume — save and load chat sessions to continue work later
• 24 LLM providers — Anthropic, OpenAI, Ollama, Gemini, OpenRouter, Requesty, Cloudflare Workers AI, Moonshot, DeepSeek, Qwen, Groq, Mistral, Together, Fireworks, xAI, Cohere, SambaNova, MiniMax, Llama, GitHub Models, HuggingFace, Zhipu, Perplexity, DemonRoute, plus any OpenAI-compatible endpoint via Custom
• Context-aware — automatically includes document state (objects, properties, selection) in prompts
• Error self-correction — failed code is sent back to the LLM for automatic retry (up to 3 attempts)
• AGENTS.md support — project-level instructions with include directives and variable substitution