Home
Alpha software -- this project is in early development. Expect rough edges, breaking changes, and the occasional FreeCAD crash from LLM-generated code. Save your work frequently.
FreeCAD AI is a workbench that adds an AI chat assistant to FreeCAD. Describe what you want to build in plain language and the assistant creates 3D models using structured tool calls or generated Python code. It supports multiple LLM providers, reusable skills, and project-level instructions -- all with zero external Python dependencies.
- Chat interface -- dock widget with streaming LLM responses
- Plan / Act modes -- review generated code before execution (Plan) or let the assistant execute automatically (Act)
- 21 built-in tools -- structured FreeCAD operations (sketch, pad, pocket, revolve, loft, sweep, fillet, boolean, etc.) wrapped in undo transactions
-
6 built-in skills -- reusable instruction sets invoked via
/command(enclosure, gear, fastener holes, thread inserts, lattice, skill-creator) - Thinking mode -- enable LLM reasoning chains (Off / On / Extended) for complex multi-step tasks
- Context compacting -- automatically summarizes older messages when approaching context limits
- Session resume -- conversations auto-save; reload any of the last 20 sessions
- Multiple LLM providers -- Ollama, Anthropic, OpenAI, Gemini, OpenRouter, or any OpenAI-compatible endpoint
- AGENTS.md support -- project-level instructions with include directives and variable substitution
- MCP integration -- connect external Model Context Protocol servers to extend available tools
-
Zero external dependencies -- uses only Python stdlib (
urllib,json,threading,ssl)
- Installation -- clone or symlink the repo into FreeCAD's Mod directory
- Configuration -- select a provider, enter your API key, test the connection
- Getting Started -- open the chat panel and build your first model
Requires FreeCAD 1.0+ and an LLM provider (local Ollama or a cloud API key).
| Provider | API Key | Notes |
|---|---|---|
| Ollama | No | Local models, default http://localhost:11434
|
| Anthropic | Yes | Claude models via native API |
| OpenAI | Yes | GPT and o-series models |
| Gemini | Yes | Google AI via OpenAI-compatible endpoint |
| OpenRouter | Yes | Multi-provider gateway |
| Custom | Varies | Any OpenAI-compatible endpoint |
- Tutorial: Simple Box -- create a parametric box from scratch (beginner)
- Tutorial: Enclosure -- build an electronics enclosure with lid and snap-fit (intermediate)
- Tutorial: Gear -- generate an involute spur gear (intermediate)
See Tutorials for the full list.