Standalone command-line slicer derived from BambuStudio's libslic3r. AGPLv3.

slicer-cli is the AGPL boundary that closed apps subprocess. Run it directly, embed it in CI, or wrap it from any tool that wants reproducible BambuStudio- compatible STL → gcode slicing without dragging in a UI.

AGPL-3.0-or-later. See LICENSE.

This project is derived from BambuStudio (also AGPLv3), which is derived from PrusaSlicer (also AGPLv3), which is derived from Slic3r (AGPLv3). The full attribution chain — including bundled sub-libraries and their licenses — is in NOTICE.

If you run slicer-cli (or a modified version of it) on a server and let network users interact with it, AGPL § 13 requires you to offer them the source. The recommended pattern is a "Source" link in the UI of whatever service wraps the binary. The Helio closed apps wrap slicer-cli via subprocess invocation only — no AGPL linking — so their UIs are not bound by § 13; this README is for direct downstream consumers who are.

• Reads STL or 3MF input.
• Resolves a printer / filament / process profile triple (BBL profile schema — same as BambuStudio).
• Generates G-code byte-identical to what BambuStudio Desktop would produce for the same inputs (within the supported-feature matrix below).

This is libslic3r-headless. The following upstream features are intentionally excluded; full list with rationale and user-visible behaviour in docs/slicer-cli-supported-features.md:

• SLA hollowing (OpenVDBUtils.cpp, SLA/Hollowing.cpp)
• Mesh cutting (CutSurface.cpp — incompatible with system CGAL 6.x)
• User post-processor scripts (PostProcessor.cpp — security-sensitive, out of v1 scope)
• Network printer push (GCodeSender.cpp)
• Pressure equalizer (PressureEqualizer.cpp)

Any of these surfacing as a CLI flag returns a clear capability error rather than silently mis-processing. A regression test per excluded feature pins the behaviour.

Dependencies are system packages — see install_deps.sh.

git clone --recurse-submodules https://github.com/<org>/slicer-cli.git
cd slicer-cli
./install_deps.sh        # installs Homebrew / apt packages
mkdir -p cli/build && cd cli/build
cmake ..
cmake --build . -j
./slicer_cli --help

Submodule pin: references/BambuStudio is pinned at a known-good commit (see .gitmodules). Bumping the pin is a deliberate maintenance action — it can ripple through the override layer and the patched libigl tree. Test on a feature branch first.

Release builds are produced by GitHub Actions (.github/workflows/) for:

• Linux x86_64 + arm64 (static where licence-compatible)
• macOS arm64 + x86_64 (notarized via Apple Developer ID)
• Windows x86_64 (Authenticode-signed)

Each release is a relocatable binary: non-system dylibs are bundled inside the package with corrected install names. A clean-host smoke test in CI verifies the binary runs on a host with no Homebrew dependencies preinstalled.

Package metadata identifies the artefact as slicer_cli (not BambuStudio). A CI assertion fails the build if the metadata regresses.

slicer-cli uses semver. The major version may bump when the supported- feature matrix narrows. The version reported in gcode headers is the pinned BambuStudio submodule version + a slicer-cli/<version> suffix so you can tell which lineage produced the output.

See CONTRIBUTING.md. External PRs require signing the CLA (preserves dual-licence optionality) and a green CI build on all three platforms.

See SECURITY.md for the disclosure policy.

slicer-cli is one of two repos in the Helio source release:

• slicer-cli (this repo, public AGPLv3) — the engine.
• helio-platform (private, commercial) — the Tauri client, the Rust MCP server, the React UI, the rust-server cloud deploy, the Helio agent intelligence. Subprocess-invokes slicer-cli. No linking, no AGPL propagation.

This separation is intentional: AGPLv3 stays pinned to the engine where it actually matters; closed-product code stays closed without cross-contaminating licences.