fabprint 0.1.52

Headless 3D print pipeline: arrange, orient, slice, and send to printer from a TOML config

fabprint

Reproducible 3D print pipeline: define parts, slicer settings, and printer targets in a TOML file — arrange, slice, and print from the command line.

Why fabprint?

Code-CAD tools like build123d, OpenSCAD and cadquery let you define parts in code — parametric, testable, version-controlled. But the moment you print, that breaks: open a slicer GUI, drag in files, fiddle with settings. No diffs, no reproducibility.

fabprint closes the gap:

• Everything is text — TOML config, git-friendly, diffable
• Pinned profiles — lock exact slicer, filament, and process profiles in your repo
• Slicer overrides — tweak support, bed type, wall count without touching profile files
• Versioned Docker slicing — pin OrcaSlicer version for identical gcode across machines
• One command — fabprint run goes from STL files to a running print

How is this different from OrcaSlicer CLI?

This builds on OrcaSlicer CLI, but is designed to allow other slicers like Cura to plugin.

OrcaSlicer CLI slices one plate of pre-arranged models. fabprint is a pipeline around it:

• Arrangement — bin-packs multiple STLs onto the build plate (OrcaSlicer CLI has no arrange step)
• Multi-part filament mapping — per-part filament slot assignment and paint color preservation, injected into the 3MF metadata
• Reproducible builds — pin slicer profiles into your repo + lock OrcaSlicer version in Docker = identical gcode on any machine
• Partial execution — --until plate to inspect layout, --only slice to re-slice, --dry-run to test everything
• Send to printer — Bambu LAN, Bambu Cloud, and Moonraker (experimental), with live status monitoring
• Headless Docker slicing — no GUI, no display server, works in CI

Quick start

pip install fabprint                # STL + 3MF support, LAN + cloud printing
pip install "fabprint[step]"        # add STEP file support (build123d)

Generate a config with the interactive wizard, or dump a commented template:

fabprint init                       # interactive wizard — discovers profiles and CAD files
fabprint init --template            # dump a commented template to stdout
fabprint init --template > fabprint.toml   # save template and edit manually

Or create fabprint.toml by hand (see full config reference):

[pipeline]
stages = ["load", "arrange", "plate", "slice", "print"]

[printer]
name = "workshop"       # references ~/.config/fabprint/credentials.toml

[plate]
size = [256, 256]       # build plate dimensions in mm
padding = 5.0

[slicer]
engine = "orca"
version = "2.3.1"       # pin OrcaSlicer version for reproducibility
printer = "Bambu Lab P1S 0.4 nozzle"
process = "0.20mm Standard @BBL X1C"

[slicer.overrides]
enable_support = 1
curr_bed_type = "Textured PEI Plate"

[[parts]]
file = "frame.stl"
rotate = [180, 0, 0]    # flip so mounting plate faces down
filament = "Generic PETG-CF @base"

[[parts]]
file = "wheel.stl"
copies = 5
orient = "upright"
filament = "Generic PETG-CF @base"

Run it (see full CLI reference):

fabprint run                   # arrange, slice and send to printer
fabprint run --until plate     # stop after plating
fabprint run --until slice     # stop after slicing
fabprint run --dry-run         # full pipeline without sending to printer

The plate stage generates a plate_preview.3mf — open it in any 3MF viewer to check placement:

Reproducibility

Pin profiles into your repo so builds are identical across machines:

fabprint profiles pin          # copies slicer profiles into ./profiles/
git add profiles/              # commit to lock them

Combined with version = "2.3.1" in [slicer] (which pins the Docker image), the same config always produces the same gcode.

CLI overview

fabprint init                        # interactive config wizard
fabprint init --template             # dump commented TOML template
fabprint validate                    # check config for issues
fabprint setup                       # set up a printer (credentials + connection type)
fabprint run                         # full pipeline
fabprint run --until plate           # stop after plating
fabprint run --only slice            # run just one stage
fabprint run --dry-run               # everything except sending to printer
fabprint login                       # log in to Bambu Cloud
fabprint watch                       # live printer dashboard
fabprint status                      # query printer status
fabprint profiles list               # list available slicer profiles
fabprint profiles pin                # pin profiles for reproducible builds

Documentation

• CLI reference — all commands, flags, and pipeline stages
• Config reference — complete TOML format
• Developing — setup, testing, architecture

License

Apache 2.0