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
| Example | Difficulty | Key Feature |
|---|---|---|
| Minimal Agent | Basic | Bare 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