Deploy Trinity Agent Orchestration Platform

git clone https://github.com/ability-ai/trinity.git
cd trinity

cp .env.example .env

# Edit .env with your configuration:
# - Model API keys (ANTHROPIC_API_KEY, GOOGLE_API_KEY, etc.)
# - Admin credentials for the dashboard
# - Git repository URL for encrypted credential storage (optional but recommended)

docker compose up -d

This starts:

• Trinity Core: The orchestration engine and API server
• PostgreSQL: Persistent state for agents, schedules, and execution history
• Redis: Job queue for cron-triggered tasks
• Dashboard: Web UI for monitoring and management (default: http://localhost:8080)
• MCP Server: Exposes 116 tools for external orchestration via Model Context Protocol

Through the dashboard or API:

curl -X POST http://localhost:8080/api/agents \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TRINITY_TOKEN" \
  -d '{
    "name": "research-agent",
    "runtime": "claude-code",
    "model": "claude-sonnet-4-6",
    "container_config": {
      "cpu_limit": 2,
      "memory_limit": "4g"
    }
  }'

Each agent runs in its own isolated Docker container with:

• Dedicated resources (CPU, memory)
• Multi-runtime support (Claude Code or Gemini CLI)
• Model selection per task
• Shared folders via Docker volumes for agent-to-agent file exchange

curl -X POST http://localhost:8080/api/schedules \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TRINITY_TOKEN" \
  -d '{
    "agent_id": "research-agent",
    "cron": "0 9 * * 1",
    "task": "Compile a weekly research digest from arXiv papers in the AI agents category",
    "output_channel": "slack"
  }'

The agent will execute autonomously at the scheduled time, with full execution streaming visible in the dashboard.

Trinity supports hierarchical delegation with fine-grained permissions:

curl -X POST http://localhost:8080/api/agents \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TRINITY_TOKEN" \
  -d '{
    "name": "writer-agent",
    "runtime": "claude-code",
    "model": "claude-sonnet-4-6",
    "parent_agent": "research-agent",
    "permissions": ["read:shared", "write:shared"]
  }'

The research agent can now delegate writing tasks to the writer agent. Both run in parallel containers with shared volumes.

Trinity's MCP server exposes 116 tools for external orchestration from Claude Code, Cursor, or any MCP client:

{
  "mcpServers": {
    "trinity": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-client", "http://localhost:8080/mcp"]
    }
  }
}