<div class="hero" markdown>
  <img src="img/logo.svg" alt="LLM Council">
  <h1>llm-council</h1>
  <p>Multi-LLM deliberation through peer review and synthesis</p>
  <div class="hero-buttons">
    <a href="getting-started/quickstart/" class="primary">Get Started</a>
    <a href="https://github.com/amiable-dev/llm-council" class="secondary">GitHub</a>
  </div>
</div>

## What is LLM Council?

Instead of asking a single LLM for answers, LLM Council:

1. **Stage 1**: Sends your question to multiple LLMs in parallel (GPT, Claude, Gemini, Grok, etc.)
2. **Stage 2**: Each LLM reviews and ranks the other responses (anonymized to prevent bias)
3. **Stage 3**: A Chairman LLM synthesizes all responses into a final, high-quality answer

## Key Features

- **Multi-model deliberation** - Get answers validated across multiple AI models
- **Peer review** - Anonymous evaluation prevents model favoritism
- **Flexible integration** - Use as MCP server, HTTP API, or Python library
- **Confidence tiers** - Quick, balanced, high, and reasoning modes
- **Jury mode** - Binary verdicts for go/no-go decisions
- **Verification & CI gating** - Machine-actionable pass/fail/unclear verdicts with calibrated confidence ([guide](guides/verify.md))
- **Cost transparency** - Real per-model/per-stage token + USD accounting on every response (ADR-011)
- **Live streaming** - Watch the deliberation unfold: per-model SSE events and chairman token streaming ([guide](guides/streaming.md))
- **Quality benchmark** - Golden-dataset drift regression and a quality-per-dollar matrix ([guide](guides/bench.md))
- **MCP 2026-ready** - Server Card discovery, durable task store, stateless-deployment audit (ADR-045)

## Quick Start

```bash
# Install
pip install "llm-council-core[mcp,secure]"

# Set API key
export OPENROUTER_API_KEY="sk-or-v1-..."

# Use with Claude Code
claude mcp add llm-council --scope user -- llm-council
```

Then in Claude Code:

```
Consult the LLM council about best practices for error handling
```

## Use Cases

- **Code review** - Get multiple AI perspectives on code changes
- **Architecture decisions** - Validate design choices with AI jury
- **Content validation** - Check factual accuracy across models
- **Complex problem solving** - Leverage diverse AI reasoning

## Community

- **[Discord](https://discord.gg/y467DGHF)** - Real-time chat and support
- **[GitHub Discussions](https://github.com/amiable-dev/llm-council/discussions)** - Q&A and ideas
- **[Contributing Guide](contributing.md)** - Help improve LLM Council

## Next Steps

- [Installation](getting-started/installation.md) - Detailed setup instructions
- [Quick Start](getting-started/quickstart.md) - Get up and running in 5 minutes
- [Configuration](getting-started/configuration.md) - Customize your council
