Design physical products with AI. [Website](https://www.texttocad.dev) [](https://pypi.org/project/cadgen/) [](https://github.com/earthtojake/text-to-cad/actions/workflows/test.yml?query=branch%3Amain) [](LICENSE) [](https://skills.sh/earthtojake/text-to-cad) [](https://pepy.tech/projects/cadgen) [](https://discord.gg/5FGB9DwJYU) [](https://x.com/earthtojake) [](https://github.com/sponsors/earthtojake)

text-to-cad

The text-to-cad plugin gives your agent local workflows for generating 3D models as STEP, GLB, STL or 3MF files. It also does design for manufacturing checks, generates engineering drawings, and connects to popular 3D printing, sheet metal and CNC fabrication services.

It is supported by all popular agents that support plugins or the skills framework, including Claude Code, Codex, Cursor, Gemini and Grok.

How it works

1. Your agent writes each model as a Python script with build123d, built on Open CASCADE.
2. Running the script, python model.py, builds the model with cadgen's engine into an .xbf document (its parts, names, colours, materials and joints) and the STEP, GLB, STL or 3MF files the script declares. The engine keeps each model's work in memory, so an edit rebuilds only what it changed.
3. The CAD viewer shows the model in your agent app or your browser, and follows every rebuild.

🚀 Quickstart

macOS and Linux:

curl -fsSL https://texttocad.dev/install.sh | sh

Windows, in PowerShell:

irm https://www.texttocad.dev/install.ps1 | iex

It installs uv if it is missing, then sets up text-to-cad in every agent app on your computer with each app's own commands (the plugin, which brings the skills and CAD's MCP server, or for an agent without a plugin the skills alone), registers the cadgen command, and stops an older release's engine that nothing is using. Run it again to update everything; it lists the apps to restart.

Then ask your agent for a part or an assembly: it writes the model as a Python script, runs it to build the model and shows it in the CAD viewer.

Installing by hand, app by app, and updates: docs/install.md

🧰 Skills

Install the library to give agents focused workflows for CAD, fabrication, robot description files, simulation, and local review.

🛠️ Contributing

text-to-cad is MIT-licensed and built in the open.

• Bugs and plugin requests: open an issue. A bug report with the model script and the output of cadgen doctor is the fastest to fix, and an agent app without a plugin gets one on request. A security problem is reported privately, as SECURITY.md says.
• Questions, ideas and what you made: the Discord. Say what the skills got wrong, too: that is what improves them.
• Code, skills and models: a new skill (a fabrication service, a printer, a CAD workflow) goes in skills/, an example model in models/, and fixes anywhere. CONTRIBUTING.md has the local setup and how to test in the agent apps; an agent working in the repository starts at AGENTS.md.

By default, text-to-cad sends usage stats and crash reports, tagged with a random ID and never including your files, paths or prompts. The privacy policy says what is sent and how to turn it off.