cadgen
STEP-first CAD artifact generation runtime for CAD agent skills, built on build123d and OCCT.
The package boundary is intentionally narrow: it owns artifact generation,
validation, selector/topology extraction, mesh settings, source hashing, and the
cadgen-step-artifact CLI. It also includes small generated-script helpers such
as cadgen.assembly.AssemblyHelper, which wraps native build123d labels, joints,
and compounds without owning skill-specific UX. Prompts, viewer UI, and snapshot
job orchestration stay in their owning skills.
cadgen is developed in
earthtojake/text-to-cad and was
previously named cadpy inside that repository.
Public API
The supported import surface is the root cadgen exports plus the top-level
cadgen.* modules:
- Generator-script helpers: root exports (
AssemblyHelper,MateRelation,MateTarget,label_text,label_shape,target,ensure_step_glb_artifact,validate_step_glb_artifact),cadgen.assembly, andcadgen.step_scene(import_step,load_step_scene,located_shape,occurrence_selector_id,scene_occurrence_shape). - Generator-script helpers (2D):
cadgen.sources(load_source_module) andcadgen.flatten(planar-face projection/unfold, contour emission, kerf offsetting) for.dxf.pydrawing generators. - Skill CLI surface:
cadgen.generation(generate_step_targets,generate_dxf_targets,targets_include_output_pairs),cadgen.catalog,cadgen.metadata,cadgen.analysis,cadgen.lookup,cadgen.cad_ref_syntax,cadgen.selector_types,cadgen.reporting,cadgen.cli_logging,cadgen.render,cadgen.step_artifacts,cadgen.step_targets,cadgen.step_export,cadgen.drawing_checks(DXF drawing validation), andcadgen.drawing_render(DXF render payload + SVG snapshots). - Process entry points:
cadgen-step-artifact,python -m cadgen.step_artifact_cli,python -m cadgen.step_export_target, andpython -m cadgen.dxf_artifact.
Everything under cadgen._internal is private implementation (the STEP scene,
generation, GLB/topology, and export engines live there) with no import
stability between releases; cadgen.generation and cadgen.step_scene are
thin facades over those engines that re-export only the supported names.
Install
Released versions are published to PyPI by the repository's Release workflow;
the package version always matches the CAD plugin release version:
python -m pip install cadgen
Production skill bundles pin the exact release version in their
requirements.txt (for example cadgen==0.4.0) and keep a vendored copy of
this package as an offline fallback:
python -m pip install ./scripts/packages/cadgen
Local Development
Install it editable into the repo CAD runtime when working on the source package directly:
./.venv/bin/python -m pip install -e packages/cadgen
After that, changes under packages/cadgen/src/cadgen are immediately visible to
local source checkouts that import the package directly.
On develop, the CAD skill and root Viewer point at this package through the
development symlinks skills/cad/scripts/packages/cadgen and
viewer/packages/cadgen. Keep those links intact with
scripts/dev/setup-symlinks.sh --check.
Production Bundling
Build a wheel and install it into each skill's bundled Python environment during packaging:
./.venv/bin/python -m build packages/cadgen
python -m pip install packages/cadgen/dist/cadgen-*.whl
The CAD and cad-viewer skills should depend on the package artifact they bundle,
not on skills/cad or the repository root. Production packaging vendors
installable packages under skills/cad/scripts/packages/cadgen and
skills/cad-viewer/scripts/viewer/packages/cadgen; production packaging can also
set VIEWER_CAD_PYTHON to a skill-local Python runtime with this package
installed. Production skill bundles install cadgen==<release version> from
PyPI first and fall back to the vendored copy when offline.
1 maintainer
Metadata
1 maintainer
Release files for cadgen 0.4.20
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cadgen-0.4.20.tar.gz | 279.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cadgen-0.4.20-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 598.4 kB
Release files / cadgen-0.4.20.tar.gz
| Download URL | cadgen-0.4.20.tar.gz |
|---|---|
| Size | 279.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ad962ffaed7002b01e0c8c7e79d92fb1f2e90f77984044b23d53b9f4446da73c
|
|
BLAKE2b-256 checksum How to use checksums |
5abe9a93fb324f944b5ac0527c90200a0cb0a395ec9468743c5cc931fd460b6f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Aug 19, 2026.
Transparency logRelease files / cadgen-0.4.20-py3-none-any.whl
| Download URL | cadgen-0.4.20-py3-none-any.whl |
|---|---|
| Size | 318.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5a1f458f94eeda4508232b0f3ba15b7ab928970b2701ae7c08c71ba6f2534328
|
|
BLAKE2b-256 checksum How to use checksums |
c769c6fc4e08173e47a030a9f030ab01292fa7f4241c8efaae6363f2b0c10ffb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 Aug 19, 2026.
Transparency log
