Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

draftwright: technical drawings, generated

crates.io CI Licence: AGPL-3.0

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.

An A3 drawing of NIST test part CTC-03, a sheet-metal bracket, with plan and elevation views, an isometric view, a hole table, datums and GD&T frames
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, pdf_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 returns (svg_path, pdf_path) as strings; the second file is now PDF, not DXF. DXF export and 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.io lets 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 draftwright crate'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.
  • Lays out sheets. Views, sections, detail views and hole tables go on ISO 5457 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. pack draws each made part once and writes an ISO 7573 parts list, item numbers and a CSV/JSON bill of materials.
  • Tracks revisions. diff carries 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.

Circular flange drawing NEMA 17 mount bracket drawing NIST FTC-06 drawing with hole tables and a section
Flange: bolt circle callout Bracket: slots, chamfers, fillets NIST FTC-06: hole tables, GD&T, section

Documentation

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.

  • 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.0a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for draftwright 0.6.0a1
File Actions
draftwright-0.6.0a1-cp39-abi3-win_amd64.whl CPython 3.9 abi3 Windows x86-64 Details for draftwright-0.6.0a1-cp39-abi3-win_amd64.whl
draftwright-0.6.0a1-cp39-abi3-manylinux_2_28_x86_64.whl CPython 3.9 abi3 Linux glibc 2.28+ x86-64 Details for draftwright-0.6.0a1-cp39-abi3-manylinux_2_28_x86_64.whl
draftwright-0.6.0a1-cp39-abi3-manylinux_2_28_aarch64.whl CPython 3.9 abi3 Linux glibc 2.28+ ARM64 Details for draftwright-0.6.0a1-cp39-abi3-manylinux_2_28_aarch64.whl
draftwright-0.6.0a1-cp39-abi3-macosx_11_0_arm64.whl CPython 3.9 abi3 macOS 11.0+ ARM64 Details for draftwright-0.6.0a1-cp39-abi3-macosx_11_0_arm64.whl
draftwright-0.6.0a1-cp39-abi3-macosx_10_12_x86_64.whl CPython 3.9 abi3 macOS 10.12+ x86-64 Details for draftwright-0.6.0a1-cp39-abi3-macosx_10_12_x86_64.whl

Total release size: 73.5 MB

Release files / draftwright-0.6.0a1-cp39-abi3-win_amd64.whl

Download URL draftwright-0.6.0a1-cp39-abi3-win_amd64.whl
Size 15.7 MB
Tags CPython 3.9 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
e436bce6b24418e944337295eadf8290fa62c860f8b649a61bc7e58a1b78137c
BLAKE2b-256 checksum
How to use checksums
935668194b894c611ffb6fa05ec52677db09b087f0ce93ed6a3b4f53244a919c
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 11, 2026.

Transparency log

Release files / draftwright-0.6.0a1-cp39-abi3-manylinux_2_28_x86_64.whl

Download URL draftwright-0.6.0a1-cp39-abi3-manylinux_2_28_x86_64.whl
Size 15.4 MB
Tags CPython 3.9 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
1a6c4644f0557aa8764db3bba7591ff7faeca9c083f310ced20744968032904f
BLAKE2b-256 checksum
How to use checksums
a46ea27d8a34bcd9b3bf2f23f77fe4ef08138306f36aa980a4f047e54c5b4995
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 11, 2026.

Transparency log

Release files / draftwright-0.6.0a1-cp39-abi3-manylinux_2_28_aarch64.whl

Download URL draftwright-0.6.0a1-cp39-abi3-manylinux_2_28_aarch64.whl
Size 14.0 MB
Tags CPython 3.9 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
40a1a08ce89b6e1fb861d11b3b63c5d2b4cdd08159db05617f74ab8dc0d9c082
BLAKE2b-256 checksum
How to use checksums
26594774147af0c66a6fd5e3597a9bede19dc9283b577c56bf7c24881a428aa2
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 11, 2026.

Transparency log

Release files / draftwright-0.6.0a1-cp39-abi3-macosx_11_0_arm64.whl

Download URL draftwright-0.6.0a1-cp39-abi3-macosx_11_0_arm64.whl
Size 13.7 MB
Tags CPython 3.9 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
27257d71f174dda457caa84298500935f0050721211f48d37f85e38d2f934035
BLAKE2b-256 checksum
How to use checksums
4146307ff4215f5910ea6a6100dc9b633cefb9fb2b435a982bdb69cc69024082
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 11, 2026.

Transparency log

Release files / draftwright-0.6.0a1-cp39-abi3-macosx_10_12_x86_64.whl

Download URL draftwright-0.6.0a1-cp39-abi3-macosx_10_12_x86_64.whl
Size 14.7 MB
Tags CPython 3.9 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
83f75b8e7627e61882639c40a744593c26537eae8dd654ef2bfb88ffeb688b07
BLAKE2b-256 checksum
How to use checksums
de1ad75157dd9d95982e25dedb5ddf125684f5e74225b758ce63f130a6390701
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 11, 2026.

Transparency log

Security for draftwright 0.6.0a1

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.

Select from 5 files

Attestation for draftwright-0.6.0a1-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 11, 2026.

Transparency log

A 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.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page