Skip to main content
cli_deploy_cmd This guide walks you through deploying an agent from scratch.

Prerequisites

Step 1: Create Agent Directory

Step 2: Create agent.yaml

Every agent needs a configuration file:
Key fields:
  • name: Unique identifier for your agent
  • runtime: python3 or nodejs20
  • entrypoint: Function that handles requests
  • min_workers: Keep this many workers always ready

Step 3: Create Your Handler

agent.py
The handler receives JSON input and returns JSON output.

Step 4: Deploy

What happens:
  1. Agent packaged and sent to daemon
  2. Workspace created at ~/.orpheus/workspaces/my-agent/
  3. Worker pool started with min_workers
  4. Agent ready to receive requests

Step 5: Verify

Step 6: Run Your Agent

Output:

Updating Your Agent

After changing code, redeploy:
Workers restart with new code. Workspace files are preserved.

Removing an Agent

This deletes the workspace. Back up files first if needed.

Next Steps

Add Sessions

Make your agent stateful

Use Workspace

Persist files across requests