Skip to main content

​
Configuration File

Configure your agent environment with agent.config.yaml: 
version: "0.1"
image: "my-agent:latest"

build:
  python_version: "3.12"
  python_project: "pyproject.toml"
  system_packages: [] # Additional system dependencies (e.g., "git")

runtime:
  handler: "handle_query:Handler" # Python module and class

​
Configuration Options

​
Version

version: "0.1"
The configuration schema version. Always use "0.1" for now.

​
Image

image: "my-agent:latest"
The Docker image name and tag for your agent.

​
Build Configuration

build:
  python_version: "3.12"
  python_project: "pyproject.toml"
  system_packages: []
  • python_version - Python version to use (3.12 or higher recommended)
  • python_project - Path to your pyproject.toml file
  • system_packages - List of system packages to install (e.g., git, ffmpeg, imagemagick)

​
Runtime Configuration

runtime:
  handler: "handle_query:Handler"
  • handler - Python module and class for your handler (format: module:ClassName)

​
Common System Packages

If your agent needs additional system dependencies, add them to system_packages: 
build:
  python_version: "3.12"
  python_project: "pyproject.toml"
  system_packages:
    - git           # Version control operations
    - ffmpeg        # Audio/video processing
    - imagemagick   # Image manipulation
    - curl          # HTTP requests
    - postgresql    # Database client

​
When to Rebuild

You need to rebuild with sb0 build when you change:
  • system_packages - Adding or removing system dependencies
  • python_version - Changing Python version
  • handler - Changing handler module or class name
  • image - Changing Docker image name/tag
You do NOT need to rebuild when:
  • Adding Python dependencies with uv add (for local testing with sb0 run)
  • Editing handler code in handle_query.py
Use sb0 run --prompt for rapid iteration without rebuilding. Only rebuild when ready to deploy with sb0 push.

​
Next Steps