sypho init

Scaffold a new agent project.

Usage

sypho init <NAME>

Arguments

Argument	Description
NAME	Project directory name

Flags

Flag	Description
--sidecar	Scaffold an MCP tool-group sidecar instead of an agent

Example

sypho init weather-agent
cd weather-agent

Generated Structure

weather-agent/
├── Dockerfile           # you own this — base image, deps, entrypoint
├── requirements.txt     # your agent's own Python dependencies
├── .dockerignore
└── ...starter agent code

The generated Dockerfile is a working starting point — swap in whatever framework you want to actually write your agent with (see Bring Your Own Framework), as long as it keeps a real ENTRYPOINT/CMD. A sypho.manifest.json alongside it is what the platform actually reads to authorize tools and data access.

Scaffolding a Sidecar

sypho init my-tools --sidecar

Scaffolds an MCP server project instead of an agent — useful for exposing a custom set of tools to multiple agents.

Next Steps

• build Command
• Manifest Reference
• Bring Your Own Framework