This release is a pre-release and may not be stable for production use.
Draftwright turns a 3D STEP file into a complete, dimensioned engineering drawing. It recognises the part's features (holes, patterns, slots, pockets, turned steps, threads), decides what to dimension and where, reads tolerances and GD&T from AP242 files, lays out the views on a standard sheet, and tells you anything it could not state. One Rust binary, one command, one repeatable drawing.
NIST CTC-03, drawn from its AP242 STEP file with only the title set. Every view, dimension,
hole-table entry, datum and GD&T frame is placed automatically.
Python
pip install draftwright
from draftwright import make_drawing
svg_path, dxf_path = make_drawing("part.step", out="drawing", title="Bracket")
STEP paths and build123d shapes are supported (install build123d separately for
shapes). The wheel also installs draftwright and draftwright-mcp on PATH.
Changed from 0.4: make_drawing still returns (svg_path, dxf_path) as strings,
and the DXF is now editable in CAD; the other old Python
classes/functions are unavailable. Unsupported options with non-default values
raise TypeError; old names/imports give migration guidance. Pin
draftwright<0.6 to keep the old API. The Rust engine uses a Spec.
See the Python API, keyword mapping and interrupt behaviour.
Ways to use it
- In the browser: draftwright.io. Open a STEP file, see the drawing, move and edit dimensions, add requirements, and export PDF or STEP. The whole engine runs in the browser as WebAssembly.
- With an AI agent: the hosted MCP server at
mcp.draftwright.iolets Claude, ChatGPT and other MCP clients open parts, read drawings and make changes. See docs/mcp.md. - On the command line:
draftwright render part.step -o part(below). - From Rust: the
draftwrightcrate's five stateless operations (analyse,plan,edit,render,review). See docs/model.md.
Install
With a recent stable Rust toolchain:
cargo install draftwright # installs draftwright and draftwright-mcp
Without Rust, download a ready-built archive for macOS (Apple silicon), Linux x86_64 or Windows x86_64 from the latest release.
From 0.6.0, the same two commands install from PyPI without Rust:
uv tool install draftwright # or: pipx install draftwright
PyPI releases before 0.6 use the archived
Python implementation. Starting with
0.6, this Rust project provides both commands and the small
Python API. Pin draftwright<0.6 to keep the full old API.
The old command form draftwright part.step [options] still renders a drawing;
see CLI migration for the options it keeps.
Shell completion: draftwright completions zsh (or bash, fish, powershell, elvish)
prints a completion script; see docs/engine.md for where to put it.
Quick start
draftwright render part.step -o part # part.svg and part.pdf
draftwright render part.step -o part --shaded --below # shaded views from above and below
draftwright render part.step -o part --formats pdf,png # choose formats
draftwright review part.step # the drawing as text, with what it could not state
A drawing is adjusted with a Spec: a small JSON file naming only what you want different from the automatic drawing. For example, to fill in the title block:
{ "sheet": { "title": { "title": "Mounting plate", "number": "MP-001" } } }
draftwright render part.step --spec part.drawing.json -o part
draftwright spec part.pdf # every drawing carries its Spec; this reads it back
More:
draftwright diff old.step new.step --spec part.drawing.json -o changes # carry a drawing to a new revision
draftwright pack assembly.step -o pack # drawings and parts list for an assembly
draftwright --help
What it does
- Recognises features from the B-rep with quiddity: holes and counterbores, hole patterns, slots, pockets and recesses, turned steps, grooves, chamfers and fillets, threads. Anything it cannot read is reported, not guessed.
- Dimensions completely. Each feature family has its own rules. Dimensions are placed without collisions, and every omission is reported with a reason.
- Reads PMI. Tolerances, fits, datums, GD&T frames, threads and surface finish come from AP242 semantic PMI. Specify writes requirements back into STEP.
- US drawings.
draftwright render part.step --units in --paper ansiprints decimal inches on landscape ANSI A–E paper. Use--paper archfor ARCH A–E, or--paper isofor ISO A4–A0. In Python, usemake_drawing(part, units="in", page="ANSI B"). - Lays out sheets. Views, sections, detail views and hole tables go on landscape ISO, ANSI or ARCH sheets with an ISO 7200 title block. Sheet size and scale are chosen automatically, using more sheets when needed.
- Is deterministic. The same inputs give the same bytes. SVG and PDF carry real, searchable text and embed the Spec that made them.
- Handles assemblies.
packdraws each made part once and writes an ISO 7573 parts list, item numbers and a CSV/JSON bill of materials. - Tracks revisions.
diffcarries a drawing's edits to a new revision of the part and marks up what changed.
Examples
Drawings of NIST test parts, FreeCAD and build123d parts, and assemblies, rebuilt by CI on every release, are in pzfreo/dw-examples.
| Flange: bolt circle callout | Bracket: slots, chamfers, fillets | NIST FTC-06: hole tables, GD&T, section |
Documentation
- Engine guide: building, the full command line, what is and isn't supported, known limitations, checking a change
- Model and Spec reference: the Analysis, Spec and Plan, and every setting
- Python API and migration
- MCP and agents
- Browser / WASM package
- Thread callouts · Bills of materials · Finding impact
- Changelog
Status
Draftwright is young and moving quickly: 0.2.x releases come every few days. Drawings report what they do not state, but dense parts can still be less tidy than a hand-made drawing; see Known limitations. Issues and example parts are welcome.
Related projects
- quiddity: feature recognition from STEP B-rep, and the haecceity geometry kernel Draftwright is built on.
- Specify: writes requirements (tolerances, fits, GD&T, BOM data) into STEP as AP242 PMI. It is the Specify view at draftwright.io/specify.
- dw-examples: the example drawings.
- draftwright-python: the original Python implementation, no longer developed.
Licence and contributing
Draftwright is licensed under the GNU AGPL v3.0, and is also available under separate commercial terms; contact paul@draftwright.io. quiddity and haecceity are Apache-2.0. The bundled IBM Plex fonts are under the SIL Open Font License 1.1.
Contributions are welcome. See CONTRIBUTING.md; pull requests need the Contributor License Agreement.
Metadata
Release files for draftwright 0.6.0a2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| draftwright-0.6.0a2-cp39-abi3-win_amd64.whl | CPython 3.9 | abi3 | Windows x86-64 | Details for draftwright-0.6.0a2-cp39-abi3-win_amd64.whl |
| draftwright-0.6.0a2-cp39-abi3-manylinux_2_28_x86_64.whl | CPython 3.9 | abi3 | Linux glibc 2.28+ x86-64 | Details for draftwright-0.6.0a2-cp39-abi3-manylinux_2_28_x86_64.whl |
| draftwright-0.6.0a2-cp39-abi3-manylinux_2_28_aarch64.whl | CPython 3.9 | abi3 | Linux glibc 2.28+ ARM64 | Details for draftwright-0.6.0a2-cp39-abi3-manylinux_2_28_aarch64.whl |
| draftwright-0.6.0a2-cp39-abi3-macosx_11_0_arm64.whl | CPython 3.9 | abi3 | macOS 11.0+ ARM64 | Details for draftwright-0.6.0a2-cp39-abi3-macosx_11_0_arm64.whl |
| draftwright-0.6.0a2-cp39-abi3-macosx_10_12_x86_64.whl | CPython 3.9 | abi3 | macOS 10.12+ x86-64 | Details for draftwright-0.6.0a2-cp39-abi3-macosx_10_12_x86_64.whl |
Total release size: 77.5 MB
Release files / draftwright-0.6.0a2-cp39-abi3-win_amd64.whl
| Download URL | draftwright-0.6.0a2-cp39-abi3-win_amd64.whl |
|---|---|
| Size | 16.5 MB |
| Tags | CPython 3.9 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
bc82a2ac45612b54e3b7b25b3d67d9a5e17eb30c547c1feccd06261377ee8328
|
|
BLAKE2b-256 checksum How to use checksums |
c31c86c086f32c0bdea3f869bbc30d38c74248ce8717c40a39d962d8eabed6d4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logRelease files / draftwright-0.6.0a2-cp39-abi3-manylinux_2_28_x86_64.whl
| Download URL | draftwright-0.6.0a2-cp39-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 16.2 MB |
| Tags | CPython 3.9 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
b769f055e27debf974decfdd9f0c5d3e886456f57da98eae248d94e3cafa5372
|
|
BLAKE2b-256 checksum How to use checksums |
a9fda6a975144e12a68d8d152c6d023bb75a3dbf9629fa75a94facd9d3de0bf2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logRelease files / draftwright-0.6.0a2-cp39-abi3-manylinux_2_28_aarch64.whl
| Download URL | draftwright-0.6.0a2-cp39-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 14.7 MB |
| Tags | CPython 3.9 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
c15f5156d279d73cfc1d42e664113318b0076c1dfcd98b603bcffc71d3a04a1b
|
|
BLAKE2b-256 checksum How to use checksums |
2e7a206ab85710455cc54a20bce43248177f64cbaf6d731499b9a4ebb7ba3e96
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logRelease files / draftwright-0.6.0a2-cp39-abi3-macosx_11_0_arm64.whl
| Download URL | draftwright-0.6.0a2-cp39-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 14.5 MB |
| Tags | CPython 3.9 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
3d1797677a12afeee90c9afcb7c8aa222edf1ef5209d6924cd54ee9eb718e311
|
|
BLAKE2b-256 checksum How to use checksums |
7b1a1ff7708b5576fa469777e07fa55cf3d244348477db86182a83735c786c5f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logRelease files / draftwright-0.6.0a2-cp39-abi3-macosx_10_12_x86_64.whl
| Download URL | draftwright-0.6.0a2-cp39-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 15.5 MB |
| Tags | CPython 3.9 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
b4f703a56de1f0afb462d964f728c0d837b7b147062c448b39c231d39cedc638
|
|
BLAKE2b-256 checksum How to use checksums |
8e212fc585be4ccef48abb9120606b191d5d7f194d95791a5bd4b0005172d68e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logSecurity for draftwright 0.6.0a2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 5 files in this release have been uploaded with provenance metadata.
Attestation for draftwright-0.6.0a2-cp39-abi3-win_amd64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 13, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.