Skip to main content

Custom Python Examples

The custom-python provider is the bring-your-own-framework on-ramp: any Python agent that reads a JSON object from stdin and writes a JSON object to stdout runs under AgentVisor, with no Go code required. The Custom Agent Frameworks guide is the full reference; these examples show it working.

Prerequisites​

  • Temporal — required for durable execution
  • AgentVisor CLI — agentvisor serve . starts the runtime

Examples​

ExampleDifficultyKey Feature
Minimal AgentBasicBare stdin/stdout JSON contract, no framework

How It Works​

Each example sets framework.provider: custom-python and a required framework.command in mav-agent-config.yaml, declares its agents in a hand-written .agentvisor/schema.json, and speaks the stdin/stdout JSON contract. The Custom Agent Frameworks guide covers each of these, along with the injected environment variables and how to move to a native Go provider.

Quick Start​

# Create a project from the minimal agent template
agentvisor template create custom-python/minimal-agent
cd minimal-agent

# Run with Temporal started separately
temporal server start-dev &
agentvisor serve . --sandbox=none