basetenlabs/baseten-cli v0.4.0

v0.4.0

Repository: basetenlabs/baseten-cli

Tag: v0.4.0

Published: 2026-09-02T13:03:30Z

Prerelease: no

Release notes: Download binaries below or see README for install

Highlights

⚠️ This is a pre-release and is not considered stable. CLI structure and output may change before GA.

New commands

• baseten train: full training surface, including init, push, project list, job list|describe|logs|metrics|stop|recreate|update|download, checkpoint list|files|deploy, capacity describe|update, workstation create, session describe, and cache describe.
• baseten loops: run create|list|describe|deactivate|logs, checkpoint list|files|deploy, and usage for GPU capacity.
• baseten model image build and baseten model image prepare: build a local Docker image from a model directory, or write out just the build context.
• baseten model-api usage: workspace Model APIs token usage in time buckets, with --bucket-width, --group-by, and filters for API key prefix, user, and model.
• baseten org audit-logs and baseten model audit-logs: list audit-log entries for the workspace or a single model.
• baseten model deployment rename, update-autoscaling, and update-request-backpressure.
• baseten model environment update-autoscaling, update-promotion, and update-request-backpressure.
• baseten model environment autoscaling-schedule: create, delete, list, update, and update-settings.

Command updates

• baseten model push accepts --region to pick the deployment region.
• baseten org api-key create --type accepts workspace-manage-api-keys.
• baseten truss gains --truss-version, --truss-executable, and --truss-no-forward-auth, and forwards this CLI's credentials to truss so it uses the same profile without reading your trussrc.
• Settings commands take unset-aware flags: only the flags you pass are changed, and nullable ones such as --policy accept null to clear a value.
• Log commands with --tail emit each poll batch oldest-first, so streamed output stays in chronological order.
• baseten model push prints its summary before starting --watch, --tail, or --wait.
• Model pushes and deployment patches now handle symlinks consistently: links resolving inside the model directory are archived, and links pointing outside it are rejected.
• A redirected stdin such as /dev/null is no longer treated as a terminal, so commands fail cleanly instead of prompting in non-interactive environments.

Backwards incompatible changes

• baseten truss no longer runs a truss found on PATH. It fetches and runs truss through uv tool run, so uv must be installed; pass --truss-executable (for example .venv/bin/truss) to run a specific truss, which is also required for truss commands that import your own Python code, such as chains push.

What's Changed

• Add Homebrew upgrade instructions and bump README download URLs to v0.3.0 by @cretz in https://github.com/basetenlabs/baseten-cli/pull/40
• Add development re-push coverage to model watch e2e test by @cretz in https://github.com/basetenlabs/baseten-cli/pull/41
• Skip S3 upload on model push when prepare returns no S3 key by @cretz in https://github.com/basetenlabs/baseten-cli/pull/43
• Add model image build and prepare commands by @cretz in https://github.com/basetenlabs/baseten-cli/pull/44
• Add org and model audit-logs commands by @cretz in https://github.com/basetenlabs/baseten-cli/pull/42
• Scope ssh jwt cache by credential by @cretz in https://github.com/basetenlabs/baseten-cli/pull/48
• Print model push summary before watch/tail/wait by @cretz in https://github.com/basetenlabs/baseten-cli/pull/49
• Add loops commands by @cretz in https://github.com/basetenlabs/baseten-cli/pull/50
• Add train commands by @cretz in https://github.com/basetenlabs/baseten-cli/pull/51
• Support the workspace-manage-api-keys API key type by @cretz in https://github.com/basetenlabs/baseten-cli/pull/53
• Push models through the baseten-go PushModel helper by @cretz in https://github.com/basetenlabs/baseten-cli/pull/54
• Emit each --tail poll batch oldest-first by @cretz in https://github.com/basetenlabs/baseten-cli/pull/59
• Add truss-delegating train and loops commands by @cretz in https://github.com/basetenlabs/baseten-cli/pull/57
• Don't treat /dev/null stdin as a terminal by @cretz in https://github.com/basetenlabs/baseten-cli/pull/60
• Add model-api usage command by @cretz in https://github.com/basetenlabs/baseten-cli/pull/58
• Add --region to model push by @cretz in https://github.com/basetenlabs/baseten-cli/pull/62
• Handle symlinks in patch points via the shared archive walk by @cretz in https://github.com/basetenlabs/baseten-cli/pull/63
• Add deployment and environment settings commands by @cretz in https://github.com/basetenlabs/baseten-cli/pull/66

Full Changelog: https://github.com/basetenlabs/baseten-cli/compare/v0.3.0...v0.4.0