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, 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.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.
  • US drawings. draftwright render part.step --units in --paper ansi prints decimal inches on landscape ANSI A–E paper. Use --paper arch for ARCH A–E, or --paper iso for ISO A4–A0. In Python, use make_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. 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.0a2

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.0a2
File Actions
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 log

Release 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 log

Release 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 log

Release 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 log

Release 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 log

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

Select from 5 files

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