Build from source

Build the open source engine and the tessafab command line from the GitHub repository.

The engine, the engine server and the tessafab command line are open source, in github.com/tessafab/tessafab. They’re written in Rust and build with the stable toolchain.

Build

Install Rust with rustup (on a Mac: brew install rustup && rustup default stable), then:

git clone https://github.com/tessafab/tessafab
cd tessafab
cargo build --release

The tools land in target/release/:

Binary What it is
tessafab The command line and slicer hook
tessafab-engine The engine server

Check it runs:

./target/release/tessafab --help

The examples/ folder has sliced models with ready projects. They’re .gcode.3mf files, made for the app; the command line takes one plate’s .gcode or .bgcode, as a slicer exports it.

What’s in the repository

Folder What it is
crates/pattern Patterns and assemblies, independent of any file format
crates/engine The G-code engine
crates/server The engine server (JSON-RPC over stdio), for front ends
crates/cli The tessafab command line and slicer hook
crates/dev A developer tool
patterns Every provided pattern and preset, as SVG
examples Example models, sliced, with their layouts and ready projects
fixtures Sliced plates the tests use

Limits of a source build

Built from source, the engine patterns one piece on one plate: files with more are refused, with a message saying how to slice one piece alone. The official app adds assemblies across many pieces and plates (with Pro), and its own tessafab follows the app’s licence.

Test

cargo test
cargo clippy --all-targets -- -D warnings
cargo fmt --check

Licence and contributing

The code is under PolyForm Noncommercial 1.0.0: read it, build it, change it and share it for any non-commercial purpose. The patterns and examples are under CC BY-NC 4.0. Commercial use (selling pieces, G-code or pattern packs made with TessaFab, or paid work) needs TessaFab Pro.

Bug reports, pattern ideas and pull requests are welcome; see CONTRIBUTING.md. Contributions need a contributor licence agreement, signed on your first pull request.