Journeyman
FreeCAD workbench where a provider-agnostic LLM inspects the active document and proposes FreeCAD Python for review.
What it does and how it connects
FreeCAD Journeyman is an AI assistant that works inside FreeCAD from every workbench, keeping a separate conversation for each open document. Describe the part to create or the change to make, and Journeyman inspects the active document, proposes a clear next step, performs it, and reviews the result.
It creates and modifies parametric FreeCAD models from plain-language requests, works in small undoable steps with an optional confirmation before each step, checks geometry, constraints, dimensions, and document changes after execution, renders offscreen views for image-capable models, and accepts reference images.
It connects to OpenAI, Anthropic, OpenRouter, or a local Ollama server, with ChatGPT subscription login as an option through the OpenAI Codex CLI. It installs from FreeCAD's Tools menu Addon Manager, uses FreeCAD's bundled Python with no separate package install, and saves conversation history inside the FreeCAD document.
Alternatives
Compare side by side- freecad-ai
A FreeCAD workbench with a chat interface that builds and edits 3D models from natural language through 50 structured tools and 24 LLM providers.
- FreeGAD
A FreeCAD workbench where an AI agent reads the model and applies confirmed edits as single undo transactions.
- CADialogue
The official research implementation of a multimodal conversational assistant that creates and refines parametric FreeCAD models from text, speech, and image input.
- text-to-cad (CAD Skills)
An agent skills framework that gives AI coding agents parametric CAD superpowers through the build123d Python library.
- Fusion MCPilot
A portable agent skill for Fusion 360 over MCP with reusable workflows for parametric modeling, geometry validation, and 3D-print prep.
Recurring errors it addresses
Error Index entries this tool is built to reduce or work around.
- When an agent fans out parallel create calls through the FreeCAD MCP bridge, the shared connection races: the first object is created even though its call reports failure, and the second object is silently never created with the status still showing healthy.Error Index
- A FreeCAD MCP bridge silently ignored parameters the client materialized from JSON-Schema defaults, so box(size=20) produced a default 10mm shape. The agent believes it built the requested geometry while the model is something else entirely.Error Index
- A FreeCAD MCP bridge's autosave-before-call rewrote the active document on every tool call even with zero unsaved changes, stamping phantom diffs onto git-tracked CAD files. Agent activity pollutes version control with edits no human authored.Error Index
- A CAD agent bridge's screenshot tool refused any image over a 50KB socket frame, so every real model screenshot was dropped, and images that did fit arrived as base64 text inside JSON instead of real image blocks. The agent's only visual feedback channel was dead for production-scale models.Error Index
- A FreeCAD user reports fillet/bevel as big weaknesses of FreeCAD and shows a fillet that breaks in FreeCAD and in the FreeCAD-Nxt add-on meant to fix it.Error Index
Sources
Not verified
- No GitHub releases exist, so latest release fields are null.
- No independent user voice found: recent repo issues are all by the maintainer.
- Pricing: none stated on the repo.
- A named individual builder beyond the repository owner handle mattyg
Last verified November 6, 2026. Listings are informational. The evidence score measures public, verifiable evidence and is not an endorsement or a compatibility claim.