Quickstart

Get from zero to a working adversarial debate in under a minute.

Install

bash

pip install aragora-debate

Zero-Key Demo

No API keys needed — runs with styled mock agents locally:

python

from aragora_debate import Arena, DebateConfig, 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,
    config=DebateConfig(rounds=2),
)
result = asyncio.run(arena.run())
print(result.receipt.to_markdown())

Three agents debate, critique each other, vote, and produce an audit-ready decision receipt.

Add Real AI Models

Install the provider extras for the models you want to use:

bash

pip install 'aragora-debate[anthropic]'   # Claude
# or
pip install 'aragora-debate[openai]'      # GPT
# or
pip install 'aragora-debate[all]'

Then set the matching API keys:

bash

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

Then run a real multi-model debate:

python

import asyncio
from aragora_debate import Arena, DebateConfig, create_agent

async def main():
    agents = [
        create_agent("anthropic", name="analyst"),
        create_agent("openai", name="challenger"),
    ]

    result = await Arena(
        question="Design a rate limiter for our API",
        agents=agents,
        config=DebateConfig(rounds=3, consensus_method="majority"),
    ).run()

    print(result.summary())
    print(result.receipt.to_markdown())

asyncio.run(main())

TypeScript SDK

bash

npm install @aragora/sdk

typescript

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);

Self-Host

bash

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

Landing pagelocalhost:3000

API docslocalhost:8080/api/v2/docs

Playgroundlocalhost:3000/playground

CLIaragora debate "your question"

Next Steps

Try a debate now

No install needed — run in your browser

API Reference

Full REST API documentation