FreeGAD: Claude inside FreeCAD

FreeGAD is a FreeCAD 1.0/1.1 workbench that embeds a persistent LLM agent in a docked chat panel.

It sends a compact snapshot of the live document, exposes tools that read every property, sketch constraint and spreadsheet cell, can screenshot the 3D view for visual checks, measure geometry, and (after a confirmation dialog) modify the model through the FreeCAD Python API.

Notes survive between sessions per user and per document, API keys are DPAPI-encrypted, and an opt-out telemetry backend (FastAPI + SQLite + SvelteKit dashboard) tracks latency and token usage.

What it does

• Tool-use agent loop over the live FreeCAD document with prompt caching and one conversation per document
• Vision: take_screenshot sends the rendered viewport to the model so it can verify its own edits
• Write tools (run_python, set_property, set_expression, delete_object...) gated by a confirmation dialog with the exact code, one undo step each
• Persistent memory: per-user and per-document JSON notes keyed by document Uid; chat history per document
• Provider switch between Anthropic and any OpenAI-compatible endpoint with effort/reasoning mapping
• Anonymous usage telemetry with offline spool + login-protected SvelteKit dashboard at freecad.dobrovolskiy.com

Full agentic tool loop (read + vision + gated writes + memory) embedded in a CAD host, dual-provider LLM client written from scratch on stdlib HTTP, AGPL-licensed with a FreeCAD package.xml, installer and a deployed telemetry backend.