Skip to main content

sypho deploy

Deploy an agent to the sypho platform.

Usage

sypho deploy --version <VERSION> [OPTIONS]

Options

FlagDescription
--version <VERSION>Agent version to deploy (required)
--deployments <LIST>Comma-separated deployment names to assign (optional)

Example

sypho deploy --version 0.1.0

Output:

📤 Deploying my-agent:0.1.0...
✓ Manifest registered
✓ Agent version: my-agent:0.1.0

With Deployment Assignment

sypho deploy --version 0.1.0 --deployments daniel-dev,staging

Automatically assigns the agent version to specified deployments.

What It Does

  1. Reads builds/{agent-name}/{version}/manifest.json
  2. POSTs to /agents/{name}/versions/{version}/manifest
  3. Optionally assigns to deployments

Manifest Validation

Control plane validates:

  • schema_version is "1.0"
  • execution_mode is "agent"
  • agent_config.model has provider prefix (anthropic/ or openai/)
  • All required fields present

Assignment

To assign later:

curl -X POST \
http://localhost:3000/agents/my-agent/versions/0.1.0/deployments \
-H "Authorization: Bearer sypho_..." \
-d '{"deployment_id": "748a77ff-..."}'

Viewing Deployments

curl http://localhost:3000/agents/my-agent/versions/0.1.0/deployments \
-H "Authorization: Bearer sypho_..."

Next Steps