← all repositories
basetenlabs/truss

Packaging ML models for people who hate writing Dockerfiles

Truss is a CLI that turns Python model code into containerized, GPU-aware production deployments while keeping Docker and Kubernetes out of sight.

truss
Not currently ranked — collecting fresh signals.
star history

What it does

Truss is a CLI for packaging and deploying ML models, primarily targeting Baseten’s platform. It wraps serving logic written in common Python frameworks—transformers, diffusers, PyTorch, TensorFlow, vLLM, SGLang, TensorRT-LLM—into a containerized environment, handling dependencies and GPU configuration automatically. For engine-based workflows, you can deploy entirely from a config.yaml that points to Hugging Face weights, skipping Python scaffolding and Dockerfiles altogether.

The interesting bit

The live-reload workflow patches remote deployments as you edit local files, avoiding full container rebuilds during iteration. Truss also ships a JSON schema for config.yaml, which gives you IDE autocomplete and validation instead of memorizing engine-specific flags.

Key highlights

  • Supports a broad spectrum of frameworks, from general-purpose PyTorch to optimized inference engines like TensorRT-LLM.
  • Engine-based deployments need only a config.yaml—no custom Python code or Dockerfile required.
  • Exposes an OpenAI-compatible API, so existing clients and SDKs drop in with a new base URL.
  • Live reload and IDE schema support make the development loop less tedious.
  • Claims to support both Baseten-hosted and self-managed infrastructure, with autoscaling, secrets, and caching.

Caveats

  • The documentation and quickstart are overwhelmingly Baseten-centric; the path for self-hosted or non-Baseten deployment is mentioned but not illustrated.
  • The “no Python code” engine path is convenient but appears limited to supported model architectures and Baseten’s engine builder.

Verdict

Data scientists and ML engineers who want to push models to Baseten without learning container internals will get the most value. If you need fine-grained control over your serving stack or are avoiding managed platforms entirely, Truss may abstract away too much.

Frequently asked

What is basetenlabs/truss?
Truss is a CLI that turns Python model code into containerized, GPU-aware production deployments while keeping Docker and Kubernetes out of sight.
Is truss open source?
Yes — basetenlabs/truss is open source, released under the MIT license.
What language is truss written in?
basetenlabs/truss is primarily written in Python.
How popular is truss?
basetenlabs/truss has 1.2k stars on GitHub.
Where can I find truss?
basetenlabs/truss is on GitHub at https://github.com/basetenlabs/truss.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.