Quickstart

pip install aragora-debate

from aragora_debate.arena import Arena
from aragora_debate.styled_mock import StyledMockAgent
import asyncio

agents = [
    StyledMockAgent('analyst', style='supportive'),
    StyledMockAgent('critic', style='critical'),
    StyledMockAgent('pm', style='balanced'),
]
arena = Arena(question='Should we migrate to microservices?', agents=agents)
result = asyncio.run(arena.run())
print(result.receipt.to_markdown())

export ANTHROPIC_API_KEY="sk-ant-..."   # Claude
# or
export OPENAI_API_KEY="sk-..."          # GPT

import asyncio
from aragora import Arena, Environment, DebateProtocol

env = Environment(task="Design a rate limiter for our API")
protocol = DebateProtocol(rounds=3, consensus="majority")

# Arena auto-discovers available agents from your API keys
arena = Arena(env, protocol=protocol)
result = asyncio.run(arena.run())
print(result.summary)

npm install @aragora/sdk

import { AragoraClient } from "@aragora/sdk";

const client = new AragoraClient({ baseUrl: "http://localhost:8080" });
const result = await client.debates.create({
  task: "Should we use microservices or a monolith?",
  agents: ["claude", "openai"],
  rounds: 3,
});
console.log(result.summary);

docker compose -f deploy/demo/docker-compose.yml up