Prerequisites

• Docker and Docker Compose v2+
• Anthropic API key (for Claude-powered agents) OR Google API key (for Gemini-powered agents)

Install listener dependencies

brew install websocat jq

Getting Started — Deploy an Agent in 3 Minutes

You need: a Trinity instance running somewhere (localhost or remote) and a local agent directory with CLAUDE.md and template.yaml.

```bash

1. Install the CLI

pip install trinity-cli # or: brew install abilityai/tap/trinity-cli

3. Deploy your agent

cd my-agent/ trinity deploy .

→ Writes .trinity-remote.yaml for future redeploys

5. Redeploy after changes

trinity deploy . # updates the same agent ```

Deploy from Claude Code (Plugin)

Already have a Claude Code agent? Deploy it with the Trinity plugin:

/plugin marketplace add abilityai/abilities
/plugin install trinity@abilityai
/trinity:onboard

After onboarding you get management skills: /trinity:sync (push/pull code), /trinity:remote (execute tasks), /trinity:schedules (cron automation).

Deploy a Multi-Agent System

```yaml

One-Line Install

curl -fsSL https://raw.githubusercontent.com/abilityai/trinity/main/install.sh | bash

This will clone the repository, configure environment, build the base image, and start all services.

Manual Installation

```bash

3. Build the base agent image

./scripts/deploy/build-base-image.sh

First-Time Setup

On first launch, Trinity will guide you through initial setup:

1. Open http://localhost — you'll be redirected to the setup wizard
2. Set your admin password (minimum 8 characters)
3. Log in with username admin and your new password
4. Go to Settings → API Keys to configure your Anthropic API key

Install the abilities marketplace (one-time)

/plugin marketplace add abilityai/abilities

Rebuild after changes

docker compose build backend docker compose up -d backend ```

→ Enter instance URL (e.g. trinity.example.com — bare domains work)

Quick Start

Design Guides

Example: onboard an agent to Trinity

/plugin install trinity@abilityai /trinity:onboard

Example: scaffold a new agent

/plugin install create-agent@abilityai /create-agent:create ```

See the abilities repository for full plugin documentation and installation instructions.

2. Configure environment

cp .env.example .env

Edit .env - at minimum set:

Set your MCP API key (from Settings → API Keys)

export TRINITY_API_KEY="trinity_mcp_xxx"

Configuration

Environment Variables

See .env.example for the complete list.

Via REST API

curl -X POST http://localhost:8000/api/systems/deploy \ -H "Content-Type: application/json" \ -d '{"manifest": "...", "dry_run": false}' ```

See the Multi-Agent System Guide for architecture patterns and best practices.

→ Packages directory, uploads, creates + starts the agent container

MCP Integration

Trinity includes an MCP server for external orchestration of agents:

{
  "mcpServers": {
    "trinity": {
      "type": "streamable-http",
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Comparison

---