sypho build

Build an agent's Docker image.

Usage

sypho build [OPTIONS]

Run from inside the agent's project directory (or pass a path as the default . target).

Options

Flag	Default	Description
--version <VERSION>	0.1.0	Image version tag
--pull	off	Pull the base image fresh instead of using whatever's cached locally
--name <NAME>	project directory name	Agent name, if you don't yet have a sypho.manifest.json declaring one

What It Does

1. Requires a Dockerfile in the project directory — you own it (scaffolded by sypho init, or your own).
2. If a hand-authored sypho.manifest.json is present, it's read as-is and is authoritative.
3. Runs docker build to produce the image, tagged {agent-name}:{version}.

Example

cd my-agent
sypho build --version 0.1.0

Output:

✓ Reading sypho.manifest.json
📦 Building Docker image...
[+] Building 12.3s (10/10) FINISHED
✓ Built: my-agent:0.1.0

Manifest

See the manifest reference for the full schema. A minimal example:

{
  "schema_version": "1.0",
  "agent_name": "my-agent",
  "description": "What this agent does.",
  "version": "0.1.0",
  "entrypoints": {
    "main": {
      "tools": ["structured_data_*"]
    }
  },
  "execution": {
    "command": ["python", "agent.py"]
  }
}

Local Testing

# Verify image
docker images | grep my-agent

# Run locally
docker run my-agent:0.1.0

Next Steps

• deploy Command
• Manifest Reference