TechDraw AI README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the TechDraw AI listing page.
TechDraw AI Skills
AI agent skills for turning a photograph of a physical part into engineering documentation with TechDraw AI. Draft a dimensioned 2D technical drawing, trace it into CAD-ready DXF and DWG, reconstruct the part as a 3D mesh, or render it as a finished product shot. Works with Claude Code, Claude Desktop, Cursor, Codex, VS Code, Windsurf and anything else that loads Markdown skills or speaks MCP.
Each user authenticates with their own TechDraw AI API key, and every generation is billed to their account credits. The skills call the public TechDraw AI API directly, so there is nothing extra to install and no CAD kernel to build.
One photograph, three outputs: a dimensioned drawing, CAD geometry, and a 3D model.
Install
Pick one. Each method sets the skills up for your agent.
npx skills (recommended, cross-agent)
GitHub CLI (v2.90+)
Claude Code marketplace
Inside Claude Code:
MCP server only
If you want the tools without the skills, add the MCP server directly:
Configuration for Cursor, Claude Desktop, Codex, VS Code and Windsurf is on the MCP page.
Setup script
Universal fallback:
More options in INSTALL.md. Agent-driven install, to paste into your agent: INSTALL_FOR_AGENTS.md.
Authenticate
Programmatic access is part of the Studio plan. Once you are subscribed, the simplest way to sign in is the browser flow, which mints a key from your session and hands it back over loopback so you never copy or paste a secret:
Or create one by hand at techdrawai.com/app → Settings → API keys and export it:
The key is shown exactly once at creation. Only its SHA-256 is stored, so nobody can recover it afterwards, including us. An account may hold five live keys and revoking one takes effect on the next request.
Skills
| Skill | Invoke | What it covers |
|---|---|---|
techdrawai-drafting | /techdrawai:drafting | Photo to dimensioned technical drawing. Drafting standard, sheet size, projection angle, drawing type, views, and the measurements that anchor the scale. |
techdrawai-cad | /techdrawai:cad | Everything downstream of the drawing: DXF and DWG at true size, 3D reconstruction, and product renders. |
Tools
| Tool | What it does | Cost |
|---|---|---|
generate_technical_drawing | Photo to a dimensioned, standards-compliant technical drawing | 3 credits |
image_to_dxf | Any image to real CAD contours as DXF, optionally DWG | Free |
render_product | Technical drawing to a photorealistic product render | 3 credits |
photo_to_3d | Photo to a textured 3D mesh, GLB plus FBX, OBJ, USDZ, STL | 3 credits |
identify_product | Name the object in a photo | Free |
check_credits | Balance, plan, and what each operation costs | Free |
Failed generations are refunded automatically, so an agent that retries a bad prompt does not quietly drain the balance.
Every tool writes its result to disk (./techdrawai-output/ unless you pass output_path) and returns the path rather than the bytes. A technical drawing is a megabyte-scale image, and pushing that through the protocol would burn the agent's context on something it usually just hands to the next tool.
What it looks like in practice
You: Here is a bracket,
~/photos/bracket.jpg. It is 120 mm across. I need a DXF for the laser cutter.
The DXF arrives at true size, so it goes straight to the cutter without rescaling. More patterns in COOKBOOK.md.
One measurement changes everything
Without a real measurement the dimensions are the model's best estimate and are marked nominal. With even one, every other feature is scaled proportionally from it and the whole drawing becomes internally consistent and manufacturable. If a user has not given one, ask for it. It is the single biggest quality lever in the whole workflow.
The CLI
The same package is a command-line tool when you run it with arguments instead of letting an agent speak MCP to it:
Full reference at techdrawai.com/cli.
Documentation
- API reference: every endpoint, request and response
- CLI: every command and flag
- MCP: client-by-client setup
- COOKBOOK.md: worked examples
- CONTRIBUTING.md
Licence
MIT. See LICENSE.