baseten-cli

module
v0.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 23, 2026 License: MIT

README

Baseten CLI

CLI for the Baseten Inference Platform.

⚠️ Under active development. Nothing should be considered stable at this time.

Installation

Download the latest release for your platform, extract the archive, and place the baseten executable on your PATH.

Or install v0.1.0 with a one-liner:

Linux (x64)
curl -sL https://github.com/basetenlabs/baseten-cli/releases/download/v0.1.0/baseten_0.1.0_linux_amd64.tar.gz \
  | sudo tar xz -C /usr/local/bin baseten
macOS (arm64)
curl -sL https://github.com/basetenlabs/baseten-cli/releases/download/v0.1.0/baseten_0.1.0_darwin_arm64.tar.gz \
  | sudo tar xz -C /usr/local/bin baseten
Windows (x64)

PowerShell:

Invoke-WebRequest `
  https://github.com/basetenlabs/baseten-cli/releases/download/v0.1.0/baseten_0.1.0_windows_amd64.zip `
  -OutFile baseten.zip; Expand-Archive -Force baseten.zip .

Then move baseten.exe to a directory on your PATH.

Usage

Authenticate via baseten auth login, or set BASETEN_API_KEY in the environment.

Run baseten --help (or baseten <command> --help) for the full command tree.

Deploying Models

From inside a model directory containing a config.yaml:

baseten model push

The directory defaults to the current working directory and is configurable via --dir. Useful flags:

  • --tail streams build and runtime logs to stderr after the push completes.
  • --wait blocks until the deployment reaches an active status and exits non-zero on terminal failure.
Calling a Model
baseten model predict --model-id <model-id> --data '{"prompt":"hello"}'

--model-name is also accepted. Pass --file <path> (or --file - for stdin) to send a request body from a file.

Viewing Logs
baseten model deployment logs --model-id <model-id> --deployment-id <deployment-id> --tail

Omit --tail and pass --since 1h (or --start/--end) to fetch a historical window.

Run baseten --help for more, and see docs.baseten.co for general Baseten platform documentation.

Building

To build from source, clone this repository and run:

go build ./cmd/baseten

See CONTRIBUTING.md for contribution guidelines.

Directories

Path Synopsis
cmd
baseten command
internal
cmd
deploymentpatch
Package deploymentpatch builds the deployment-patch primitives the watch loop needs: a managementapi.DeploymentPatchPoint describing a source tree (BuildPatchPoint) and the patch ops between two points (BuildPatchOps).
Package deploymentpatch builds the deployment-patch primitives the watch loop needs: a managementapi.DeploymentPatchPoint describing a source tree (BuildPatchPoint) and the patch ops between two points (BuildPatchOps).
help
Package help renders our CLI's help output and provides the Execute wrapper around cobra used by internal/cmd.Execute.
Package help renders our CLI's help output and provides the Execute wrapper around cobra used by internal/cmd.Execute.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL