Releasing Agent Files

Publish a contributed agent to the letta-ai/agent-file repository.

Required Inputs

Before starting, confirm the user has:

1. An exported .af file — the agent file to publish
2. An avatar image — any common format (PNG, JPG, WebP); does not need to be square
3. Owner ID — GitHub handle with @ prefix (e.g. @letta-ai, @cpfiffer)
4. Agent key — lowercase, hyphen-separated, URL-safe name (e.g. loop, lettabot-builder)

Workflow

1. Create the agent directory

agents/@{owner}/{agent-key}/