Describe a part. Your AI agent builds it in FreeCAD, checks it, and shows you the result.
For Windows 11. Use an AI coding agent that can edit local files and run commands.
Copy this repository's clone URL, then run:
git clone <repository-url> cad-factory
cd cad-factoryAlready have it? Run git pull inside the folder.
Open the cad-factory folder in your AI coding agent, or launch the agent from a terminal in that folder.
Create a 100 × 60 × 5 mm mounting plate with a hole near each corner. Show me the result in FreeCAD.
That's it. The agent handles the model files, build commands, and checks. Replace the part description with whatever you want to make.
Continue in the same conversation:
Make the plate 120 mm long.
Give dimensions and units when you know them. You can also describe the shape, attach a reference, or ask the agent to suggest dimensions.
Attach the datasheet and ask:
Create a KiCad footprint from this datasheet, with its 3D model.
Have KiCad 10 installed. The agent creates the library, checks it, and gives you previews and instructions for adding it to your project. The files stay with the design in output/<design>/kicad/.
- An editable FreeCAD model:
model.FCStd. - STEP and STL exports.
- Four preview images.
- Reports showing which checks passed or failed.
Each new design gets its own folder inside output/, such as output/mounting-plate/. Changes to that design update its existing model, exports, and previews. Your other designs stay untouched.
Keep asking for changes until you are happy with the result. Ask for a new design whenever you want to start another one.
If a build fails, the last working result stays intact. Ask the agent to fix the problem and try again.
Want to keep a version you can return to? Tell the agent “Save a checkpoint of this design.” Later, ask it to restore that checkpoint. Checkpoints use Git history; they do not create more output folders.
Your prompt → agent writes the model → FreeCAD builds it → checks and previews → agent reviews and fixes it.
FreeCAD does the CAD work. The AI agent translates your request into a model and runs the workflow. You review the result and ask for changes.
FreeCAD must be installed locally. No separate Python setup is needed for the workflow. Passing the checks does not automatically make a design ready to manufacture.