Agent Configuration

Configure your agent environment with agent.config.yaml

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

• Learn how to add Python dependencies
• Understand the agent handler structure