stepscribe-cad
Offline converter that distills STEP files into structured context packs covering dimensions, holes, fasteners, joints, weak spots, and labeled images that any LLM chat or coding agent can reason over.
What it does and how it connects
stepscribe-cad gives any LLM X-ray vision into a CAD model. It reads a STEP file and writes an LLM context pack with exact measurements, holes, patterns, standard parts, assembly relationships and labeled images, all computed deterministically and offline, with no AI model, no network and no upload.
The tool offers four routes to the same files. A standalone web page at http://127.0.0.1:8765 takes a dropped STEP file and shows results in tabs. A Claude Code plugin adds export, interview and review commands. The export command writes FULL, COMPACT and SMALL markdown files, a chat bundle and a zip for any AI chat. An agent skill and an MCP server cover other clients. The export also includes a data report.json with a schema, and a manifest listing every file with sizes and token estimates.
Big assemblies take minutes, and the page and the plugin show progress and an estimate, with nothing cut to go faster. The interview command asks the designer questions one at a time and rebuilds the export with the answers, and the review command produces a design review citing part IDs. Installation is one pip command for Python 3.11 or newer.
Alternatives
Compare side by side- Mechanical-AI-Skill
An AI review skill for mechanical engineering that reviews STEP assemblies and produces an engineering verdict, rather than distilling STEP files into context packs.
- cad-cae-copilot
An MCP-capable CAD and CAE workbench that writes real build123d geometry and continues into simulation, rather than distilling STEP files into context packs.
Recurring errors it addresses
Error Index entries this tool is built to reduce or work around.
- Since OCCT 7.7.0, spherical or toroidal STEP faces with a clockwise outer boundary import as the complement of the bounded patch: 18 spherical faces on a Pro/ENGINEER model grew from 693.8 to 42,569.7 mm2 while BRepCheck_Analyzer calls every face valid. A shape-healing heuristic mistakes the explicit outer boundary for a hole.Error Index
- A STEP face planted flipped on a part with a 1 to 5 micron feature passed every OpenCascade check, and the CI step meant to catch a flipped face in every file missed one of 122 on main.Error Index
Sources
Not verified
- Pricing: none stated on the repo.
- Real user voices: no real linked post read for this page.
- A named individual builder beyond the repository owner handle idris900323
- The latest release is published under the idris-botics owner name; the idris900323 repository URL still resolves and is used here as the repo.
Last verified November 6, 2026. Listings are informational. The evidence score measures public, verifiable evidence and is not an endorsement or a compatibility claim.