Complete command reference for the pullweights CLI.
Homebrew
brew install pullweights/tap/pullweights
APT (Debian / Ubuntu)
curl -fsSL https://apt.pullweights.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/pullweights.gpg echo "deb [signed-by=/usr/share/keyrings/pullweights.gpg] https://apt.pullweights.com stable main" | sudo tee /etc/apt/sources.list.d/pullweights.list sudo apt update sudo apt install pullweights
See the APT repository for details. Supports amd64 and arm64.
Direct download
Pre-built binaries for macOS, Linux, and Windows on the GitHub releases page.
From source
cargo install pullweights-cli
Config: ~/.pullweights/config.toml · Cache: ~/.pullweights/cache/
Authenticate with email and password. Stores a JWT token locally.
pullweights login
--api-urlOverride API URL (default: https://api.pullweights.com)Authenticate with an API key. Validates the key before saving. Reads from stdin if --token is omitted.
pullweights auth --token pw_...
--tokenAPI key (pw_... format). Reads stdin if omitted--api-urlOverride API URLList models in an org, or list your orgs if no argument given.
pullweights ls [org]
Upload model files to the registry. Creates the model if it doesn't exist.
pullweights push <org>/<model>:<tag> <file1> [file2] [...]
--description, -dSet model description--privateMake the model private (default: public)--type <model|dataset>Set artifact type (default: model)Delete a model or dataset from the registry. Requires org admin permission and model:delete API key scope. Prompts for confirmation unless -y is passed.
pullweights delete <org>/<model>
--yes, -ySkip confirmation promptDownload model files. Verifies SHA-256 checksums automatically.
pullweights pull <org>/<model>:<tag>
--output, -oOutput directory (default: current directory)Search for models by name or description.
pullweights search <query>
--limit, -nMax results to show (default: 20)--type <model|dataset>Filter by artifact typeShow metadata for a model version — files, checksums, and sizes.
pullweights inspect <org>/<model>:<tag>
Verify integrity of downloaded files against stored checksums.
pullweights verify <org>/<model>:<tag>
--dir, -dDirectory with model files (default: current directory)Manage API keys. Requires account:admin scope.
pullweights api-key <list|create|revoke>
List all API keys for your account.
pullweights api-key list
Create a new API key with scopes and optional restrictions.
pullweights api-key create --name "CI" --scopes model:read,model:push
--nameKey name (required)--scopesComma-separated scopes (required)--orgsRestrict to specific orgs--modelsRestrict to specific models (org/model format)--ipsRestrict to specific IP addresses--expiresExpiration date (ISO 8601 or YYYY-MM-DD)Revoke an API key by its ID.
pullweights api-key revoke <key-id>
View or update CLI configuration.
pullweights config <show|set|get>
showShow all config valuesset <key> <value>Set a config value (api_url, token, cache_dir)get <key>Get a config valueInteractive login
pullweights login
API key
pullweights auth --token pw_abc123... # Or pipe from stdin echo "pw_abc123..." | pullweights auth
Environment variable
export PULLWEIGHTS_TOKEN=pw_abc123...
Overrides the saved config token. Create keys in the dashboard.
PULLWEIGHTS_TOKENAPI key or JWT token. Overrides saved config.PULLWEIGHTS_API_URLAPI base URL. Overrides config api_url.--api-urlOverride the API URL--tokenUse a specific API token--verbose, -vEnable verbose output--help, -hShow help--version, -VShow version