bdbox

bdbox is a workshop for build123d models with live preview and interactive parameters.

Screenshot

See the documentation site for full project details!

Why?

I discovered build123d after modeling with OpenSCAD. build123d has some great advantages over OpenSCAD:

Better geometry (STEP file export) than OpenSCAD's mesh of vertexes
Common CAD operations like chamfer and fillet are simple
build123d models are Python programs, whereas OpenSCAD uses its own modeling language

Comparatively, build123d's development experience was lacking. OpenSCAD previews a model on save or hotkey, makes exporting a model render simple, and even provides a GUI for setting toplevel variables! I started with some self-made tooling to work around these drawbacks, but having to remember how to use and maintain it resulted in me working on models less.

I built bdbox to be the missing tool I wanted: Let models just define their geometry plus optional parameters, and let bdbox handle everything else!

See more background info in the documentation!

Installation

Install user-wide with uv or pipx for use across all projects:

uv tool install bdbox

pipx install bdbox

Install in any environment where pip is available:

pip install bdbox

Installation in projects

Install in a project, such as with uv or poetry:

uv add bdbox

poetry add bdbox

bdbox detects and automatically uses virtual environments also containing bdbox.

This enables running via bdbox model.py instead of uv run bdbox model.py, for example.

Works with any build123d model

Use bdbox with any existing build123d script:

# mymodel.py
from build123d import Box

result = Box(10, 10, 10)

Export geometry files:

bdbox mymodel.py export           # Export STEP files to current directory
bdbox mymodel.py export output/   # Export STEP files to output/
bdbox mymodel.py export -f stl    # Export STL files to current directory

View your model using the web UI, which includes OCP CAD Viewer and an interactive parameters panel:

bdbox mymodel.py view

Module paths work too:

bdbox mypackage.mymodule view
bdbox mypackage.mymodule export

See more about actions in the documentation!

Add parameters

Declare typed parameters with defaults and constraints:

from bdbox import Float, Int, Params, Preset, show
from build123d import Box

class P(Params):
    width = Float(10.0, min=5, max=100)
    length = Float(20.0, min=5, max=100)
    thickness = Int(2, min=1, max=10)
    presets = (
        Preset("small", width=5.0, length=8.0),
        Preset("large", width=80.0, length=40.0, thickness=5),
    )

result = Box(P.width, P.length, P.thickness)
show(result)

Or inherit from Model for reusable, importable models:

from bdbox import Float, Int, Model, Preset
from build123d import Box

class MyModel(Model):
    width = Float(10.0, min=5, max=100)
    length = Float(20.0, min=5, max=100)
    thickness = Int(2, min=1, max=10)
    presets = (
        Preset("small", width=5.0, length=8.0),
        Preset("large", width=80.0, length=40.0, thickness=5),
    )

    def build(self):
        return Box(self.width, self.length, self.thickness)

Parameters become CLI flags automatically:

python mymodel.py                 # Run with default values
python mymodel.py view            # View with live reload and parameter panel
python mymodel.py --width 50      # Override a field value
python mymodel.py --preset large  # Apply a named preset
python mymodel.py --help          # Usage info with all parameters

Export geometry files using the built-in export action:

python mymodel.py export          # Export STEP files to current directory
python mymodel.py export -f stl   # Export STL files to current directory

See more about parameters in the documentation!

Project template

This project is generated and maintained with copier-python.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bdbox-0.26.0.tar.gz (342.2 kB view details)

Uploaded Aug 12, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

bdbox-0.26.0-py3-none-any.whl (274.2 kB view details)

Uploaded Aug 12, 2026 Python 3

File details

Details for the file bdbox-0.26.0.tar.gz.

File metadata

Download URL: bdbox-0.26.0.tar.gz
Upload date: Aug 12, 2026
Size: 342.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for bdbox-0.26.0.tar.gz
Algorithm	Hash digest
SHA256	`7cd40af959c0f95ac203ea542c5cab1735baf61a459fcaee265fb2c5be2d70a0`
MD5	`72970795803099ab09ea6292eefe21a8`
BLAKE2b-256	`e521f53bb4566d8675083bc1f9be6df8054babe115a1744dce911dc4c163f7c0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for bdbox-0.26.0.tar.gz:

Publisher: release.yaml on smkent/bdbox

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: bdbox-0.26.0.tar.gz
- Subject digest: 7cd40af959c0f95ac203ea542c5cab1735baf61a459fcaee265fb2c5be2d70a0
- Sigstore transparency entry: 2431926185
- Sigstore integration time: Aug 12, 2026
Source repository:
- Permalink: smkent/bdbox@9f13fe8dded15e26d0f676390e7379131e3bb957
- Branch / Tag: refs/tags/v0.26.0
- Owner: https://github.com/smkent
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yaml@9f13fe8dded15e26d0f676390e7379131e3bb957
- Trigger Event: push