CLI Reference

All Timber commands and their options.

timber load <model_path>

Compile and cache a model locally.

timber load model.json
timber load model.json --name fraud-detector
timber load pipeline.pkl --format sklearn

Option	Default	Description
--name NAME	Filename stem	Name to register the model as
--format FMT	Auto-detect	Force input format: xgboost, lightgbm, sklearn, catboost, onnx

What it does:

1. Auto-detects (or uses forced) format
2. Parses model into Timber IR
3. Runs 6 optimization passes
4. Emits C99 source code
5. Compiles a native shared library (.so / .dylib)
6. Caches everything in ~/.timber/models/<name>/

timber serve <name>

Serve a loaded model over HTTP.

timber serve my-model
timber serve my-model --port 8080
timber serve my-model --host 127.0.0.1 --port 9000

Option	Default	Description
--host HOST	0.0.0.0	Bind address
--port PORT	11434	Bind port

The server exposes:

• POST /api/predict — run inference
• POST /api/generate — alias for predict (Ollama compat)
• GET /api/models — list loaded models
• GET /api/model/:name — model metadata
• GET /api/health — health check

timber list

List all cached models in a table.

timber list

Output:

NAME            TREES  FEATURES  FRAMEWORK  SIZE
breast-cancer   50     30        xgboost    58.0 KB
fraud-detector  100    45        lightgbm   112.3 KB

timber remove <name>

Remove a cached model and all its artifacts.

timber remove my-model

timber compile

Compile a model to C99 source without caching in the store.

timber compile --model model.json --out ./dist/
timber compile --model model.json --target targets/x86_64_avx2.toml --out ./dist/
timber compile --model model.json --calibration-data train.csv --out ./dist/

Option	Default	Description
--model PATH	Required	Model artifact path
--format FMT	Auto-detect	Input format hint
--target PATH	x86_64_generic	Target spec TOML file
--out DIR	./dist	Output directory
--calibration-data PATH	None	CSV for branch sorting pass

timber inspect <model_path>

Print model summary without compiling.

timber inspect model.json

timber validate

Validate compiled output against reference predictions.

timber validate --artifact ./dist/ --reference model.json --data test.csv

Option	Default	Description
--artifact DIR	Required	Compiled artifact directory
--reference PATH	Required	Original model file
--data PATH	Required	Validation CSV
--tolerance FLOAT	1e-5	Max allowed absolute error

timber bench

Benchmark inference performance.

timber bench --artifact ./dist/ --data test.csv --batch-sizes 1,10,100,1000

timber-accel Commands

Hardware acceleration, safety, and deployment CLI (included with timber-compiler).

timber-accel compile

Compile to SIMD, GPU, HLS, or embedded targets.

timber-accel compile --model fraud.pkl --target x86_64_avx2_simd --out ./dist
timber-accel compile --model sensor.pkl --target embedded_cortex_m4 --sign --out ./fw

Option	Default	Description
--model PATH	Required	Model file path
--target NAME	x86_64_generic	Target profile (built-in or TOML path)
--out DIR	./dist	Output directory
--deterministic	False	Deterministic build
--sign	False	Generate Ed25519 keypair and sign
--calibration-data PATH	None	CSV for branch optimization

timber-accel wcet

Worst-case execution time analysis.

timber-accel wcet --model model.pkl --arch cortex-m4 --clock-mhz 168 --safety-margin 3.0

Option	Default	Description
--model PATH	Required	Model file path
--arch ARCH	Required	Architecture: cortex-m4, cortex-m7, x86_64, aarch64, riscv64
--clock-mhz MHz	Required	CPU clock frequency
--safety-margin FLOAT	2.0	Multiplier for safety margin

timber-accel certify

Generate safety certification reports.

timber-accel certify --model model.pkl --profile do_178c --include-wcet --output cert.json

Option	Default	Description
--model PATH	Required	Model file path
--profile NAME	Required	do_178c, iso_26262, iec_62304
--include-wcet	False	Embed WCET analysis
--arch ARCH	None	Architecture for WCET (if --include-wcet)
--output PATH	certification_report.json	Output file

timber-accel sign / verify

Ed25519 artifact signing.

timber-accel sign --model ./dist --generate-key
timber-accel verify --model ./dist --sig ./dist.sig --key timber_accel.pub

timber-accel encrypt / decrypt

AES-256-GCM encryption.

timber-accel encrypt --model ./dist --key $TIMBER_KEY --output dist.enc
timber-accel decrypt --model dist.enc --key $TIMBER_KEY --output ./dist

timber-accel bundle

Create air-gapped deployment packages.

timber-accel bundle --model model.pkl --target embedded_cortex_m4 --include-source --output deploy.tar.gz

Option	Default	Description
--model PATH	Required	Model file path
--target NAME	Required	Target profile for compilation
--include-source	False	Include C source files
--include-cert	False	Include certification report
--output PATH	bundle.tar.gz	Output archive

timber-accel serve-native

Generate C++ gRPC/HTTP servers.

timber-accel serve-native --model model.pkl --grpc --port 50051
timber-accel serve-native --model model.pkl --http --port 8080 --grpc

Option	Default	Description
--model PATH	Required	Model file path
--grpc	False	Generate gRPC server
--http	False	Generate HTTP server
--port PORT	50051 (gRPC) / 8080 (HTTP)	Server port
--out DIR	./serve_native	Output directory

Environment Variables

Variable	Default	Description
TIMBER_HOME	~/.timber	Model store root directory
CC	gcc	C compiler to use for compilation
TIMBER_KEY	None	AES-256-GCM key for encrypt/decrypt operations