The podium CLI is a Python tool for managing the Podium platform.

Installation

cd podium/podium_cli
pip install -e .

Commands

Deploy

Upload an agent deployment bundle:
podium deploy ./my-agent --version 1.0.0
podium deploy ./my-agent --version 1.0.0 --agent-type custom-name

Instances

# Create a new instance
podium instance create --deployment claude-agent:1.0.0@2b795103

# List instances
podium instance list

# Get instance details
podium instance info agent_abc123

# Stop an instance
podium instance stop agent_abc123

Configuration

# View current config
podium config get

# Update config at runtime
podium config set model claude-opus-4-20250514
podium config set temperature 0.3

# View available models
podium config models

Logs

# Stream agent logs
podium logs agent_abc123

# Filter by level
podium logs agent_abc123 --level error

# Get message history
podium messages agent_abc123

Keys

# Create a new API key
podium keys create --tenant my-tenant

# List keys
podium keys list

# Revoke a key
podium keys revoke pod_abc123

Configuration

The CLI reads configuration from:
  1. ~/.podium/config.yaml
  2. Environment variables (PODIUM_URL, PODIUM_API_KEY)
  3. Command-line flags
# ~/.podium/config.yaml
url: https://podium.example.com
api_key: pod_admin_...
api_prefix: /api/v1