ghbalf/freecad-ai

What it solves

FreeCAD AI provides a natural language interface for 3D modeling in FreeCAD. It allows users to create, modify, and analyze 3D models by describing their needs in plain English rather than manually navigating complex CAD software menus and Python scripting.

How it works

The project integrates a chat interface directly into FreeCAD as a workbench. It connects to various LLM providers (such as OpenAI, Anthropic, or local Ollama instances) to translate user prompts into executable Python code. The system operates in two primary modes: "Plan" mode, where users review and validate code before execution, and "Act" mode, which can automatically execute operations using a library of over 50 structured tools (e.g., create_primitive, boolean_operation, fillet_edges) for higher reliability.

Who it’s for

It is designed for FreeCAD users who want to accelerate their design process, automate repetitive modeling tasks, or lower the barrier to entry for 3D parametric modeling through AI assistance.

Highlights

• Multi-Provider Support: Compatible with 21 LLM providers, including local and cloud-based options.
• Tool Calling: Uses structured operations to ensure safer and more reliable 3D modeling compared to raw code generation.
• Vision Integration: Supports viewport screenshots and image attachments to provide the AI with visual context of the model.
• MCP Server: Can be exposed as a Model Context Protocol (MCP) server, allowing external AI clients like Claude Desktop to control FreeCAD.
• Self-Correction: Automatically detects failed code and sends it back to the LLM for retry (up to 3 attempts).
• Zero External Dependencies: Built using only the Python standard library.