A modern, AI-assisted Python editor as a FreeCAD plugin with freely arrangeable panels, syntax highlighting, 19 supported AI providers, and extensive tools for FreeCAD automation.
Technology should make things easier—not create new barriers.
This project is designed to make AI-assisted FreeCAD development accessible to everyone: experienced professionals, beginners, students, hobbyists, and people with accessibility needs.
Accessibility is a core design principle. The workbench provides multiple experience levels, integrated help, keyboard accessibility, and AI-assisted guidance so that more people can use and learn FreeCAD with confidence.
This project does not treat artificial intelligence as a replacement for human knowledge or creativity.
Instead, AI is considered a tool—like a compiler, a calculator, or a CAD application. Its purpose is to support the user by:
- Answering questions and explaining concepts.
- Suggesting solutions.
- Assisting with debugging (error finding).
- Helping to improve code.
The user always remains in control. Every decision and every final result belongs to the person using the software.
Like every AI system, the integrated AI can make mistakes, misunderstand requirements, or generate incorrect code. AI-generated content should therefore always be reviewed before it is used.
Our goal is not to automate thinking or replace developers. Its goal is to help people learn, become more productive, solve problems more easily, and lower the barriers to FreeCAD development. If the AI helps a beginner understand something new, enables an experienced user to work more efficiently, or makes development more accessible for someone with disabilities, then it has fulfilled its purpose.
Recording tool: Peek on Linux
Get ready in just a few steps:
- Install required package: Run
pip install requestsin your Python environment. - Clone/download the repo: Place it in the FreeCAD
Modfolder (make sure the folder name is exactly:FreeCAD_MultiAI_Panel, no spaces). - Restart FreeCAD: Select the workbench "FreeCAD MultiAI Panel".
- Set up an AI provider: Follow the welcome dialog to configure an AI provider (e.g., locally with Ollama or using your own API key) — and you're done!
OS-specific installation paths (Linux/Flatpak/Windows/macOS) can be found here: Requirements & Installation
- AI-assisted Python editor: Designed for FreeCAD, featuring multi-tab support, syntax highlighting, Jedi autocomplete, and light/dark themes.
- 19 AI providers supported: Use local models (via Ollama), Claude, ChatGPT, Gemini, DeepSeek, Groq, and many more (with over 40 presets).
- Run directly in FreeCAD: F5 runs the entire macro, F9 runs only the selection. Pressing again aborts execution.
- Generate macros from plain language (FC11–FC14): Describe your macro in natural language and see the result immediately in an embedded 👁 3D preview.
- Whole project as context: Pick a project folder and the AI gets a compact map of all folders and files — and pulls in individual files by itself when it needs them.
- Unified error panel: Translate errors to your preferred language in place, have the AI explain them, or auto-fix them.
- 🎤 Voice control (offline): Navigate panels/actions and dictate text, fully offline (via Vosk), without sending data to external providers.
- Flexible UI: 10 freely arrangeable dock panels, interactive assistant, and a built-in searchable help.
- Accessibility-first: Experience levels, keyboard mode, font/contrast options, and voice input.
- Compatibility: Runs on Linux (AppImage/Flatpak), Windows, and macOS with FreeCAD 0.21+.
→ Full list: Feature Overview
The pages are ordered as a guided read—each one links to the previous and next page (← Prev · Home · Next →), so you can page through them like a book.
| Topic | Document |
|---|---|
| 1 · Quick start | quick-start.md |
| 2 · Requirements & installation | requirements.md |
| 3 · First start & welcome dialog | erststart.md |
| 4 · The user interface | oberflaeche.md |
| 5 · Panels in detail | panels.md |
| 6 · Full feature overview | feature-overview.md |
| 7 · Voice control (offline) | sprachsteuerung.md |
| 8 · AI workflow & presets | ki-workflow.md |
| 9 · AI provider setup (19) | setting-up-ai-providers.md |
| 10 · FC11–FC14 – macro from description | makro-generator.md |
| 11 · Snippets, API hints & tools panel | snippets-und-werkzeuge.md |
| 12 · Macro library | makro-bibliothek.md |
| 13 · Error panel & backup system | fehler-und-backup.md |
| 14 · Keyboard shortcuts | keyboard-shortcuts.md |
| 15 · Ollama – field report | OLLAMA_ERFAHRUNGEN.md |
| 16 · Project structure | project-structure.md |
| 17 · Known limitations | known-limitations.md |
MIT — see LICENSE. Free to use, modify and share.