Agent Configuration

​

Configuration File

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"

​

Image

image: "my-agent:latest"

​

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

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

• 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

• Adding Python dependencies with uv add (for local testing with sb0 run)
• Editing handler code in handle_query.py

​

Next Steps

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