Alpha software — этот проект находится на ранней стадии разработки. Ожидайте грубых краёв, резких изменений и редких сбоев FreeCAD из-за кода, сгенерированного LLM. Используйте с осторожностью и сохраняйте работу часто.

Ассистент-рабочий стол на базе искусственного интеллекта для FreeCAD, который генерирует и выполняет код на Python для создания 3D-моделей на основе описаний на естественном языке.

Особенности

• Чат-интерфейс — виджет док-станции с потоковыми ответами LLM
• Режимы планирования / действия — просмотр кода перед выполнением (План) или автовыполнение (Действие)
• Вызов инструментов — 50 структурированных операций FreeCAD (режим Act) для более безопасного и надёжного моделирования
• Переоценка инструментов — необязательный фильтр на основе ключевых слов или LLM отправляет в LLM только самые релевантные инструменты за ход, сохраняя токены prompt при регистрации множества инструментов + MCP-серверов
• Навыки — многоразовые наборы инструкций, которые модель вызывает автономно или через /command (корпус, шестерня, отверстия крепежных элементов, эскиз по изображению и т.д.)
• Оптимизатор навыков — автоматически улучшать инструкции по навыкам через итеративный цикл тест-оценка-модификация (/optimize-skill)
• Крючки — пользовательские 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