agorai 0.1.2

Democratic AI: Multi-agent opinion aggregation with fairness guarantees

AgorAI: Democratic AI Through Multi-Agent Aggregation

AgorAI is a Python library for building fair, unbiased AI systems through democratic multi-agent opinion aggregation. It combines social choice theory, welfare economics, and modern LLMs to enable collective decision-making with provable fairness guarantees.

🎯 What is AgorAI?

AgorAI addresses a fundamental challenge in AI: How do we make fair decisions when different perspectives disagree?

Instead of relying on a single AI model's judgment, AgorAI:

1. Gathers opinions from multiple diverse agents (different models, cultural perspectives, or stakeholders)
2. Aggregates these opinions using mathematically rigorous methods from social choice theory
3. Produces decisions with provable fairness guarantees

Perfect for: AI researchers, ML engineers, and social scientists building fair multi-agent systems.

📦 Installation

pip install agorai[all]

API Keys (Optional):

• For LLM synthesis: OPENAI_API_KEY, ANTHROPIC_API_KEY, or configure Ollama locally
• For counterfactual testing: OPENAI_API_KEY or REPLICATE_API_TOKEN

🚀 Quick Start

Use Case 1: Aggregate Opinions from Multiple Agents

The most common use case - combine utilities/opinions from multiple agents:

from agorai.aggregate import aggregate

# Three agents provide utilities for three candidates
utilities = [
    [0.8, 0.2, 0.5],  # Agent 1's utilities
    [0.3, 0.7, 0.4],  # Agent 2's utilities
    [0.6, 0.5, 0.9],  # Agent 3's utilities
]

# Use "fair" aggregation (Atkinson method)
result = aggregate(utilities, method="fair")
print(f"Winner: Candidate {result['winner']}")
print(f"Scores: {result['scores']}")

Try different methods:

# Protect minorities
result = aggregate(utilities, method="minority-focused")  # Maximin

# Resist outliers
result = aggregate(utilities, method="robust")  # Robust Median

# Democratic voting
result = aggregate(utilities, method="democratic")  # Majority

# Or use technical names
result = aggregate(utilities, method="schulze_condorcet")

See all options: Aggregation Methods Documentation

---

Use Case 2: Mitigate Bias Through Multi-Perspective Analysis

Detect and mitigate bias by synthesizing diverse cultural perspectives:

from agorai.bias import mitigate_bias

# Analyze content from multiple cultural perspectives
result = mitigate_bias(
    input_text="Is this job posting discriminatory?",
    input_image=None,  # Optional: for multimodal analysis
    aggregation_method="fair",
    num_perspectives=5  # Generate 5 diverse cultural perspectives
)

print(f"Decision: {result['decision']}")
print(f"Confidence: {result['confidence']:.2%}")
print(f"Fairness metrics: {result['fairness_metrics']}")

See full guide: Bias Mitigation Documentation

---

📚 Documentation

Core Functionality

• Aggregation Methods - All 14+ methods with parameters and examples
• Mechanism Aliases - Intuitive names for aggregation methods
• Property Analysis - Select mechanisms based on theoretical properties

Applications

• Bias Mitigation - Detect and mitigate AI bias
• Council Creation - Auto-generate diverse perspectives
• Counterfactual Testing - Causal robustness evaluation

Advanced Topics

• Queue Processing - Batch operations and benchmarking
• Visualization - Plots and explanations
• Custom Extensions - Add your own methods

Reference

• API Reference - Complete function signatures
• Configuration - Environment variables and settings
• Examples - Code examples and demos

🎓 Key Concepts

Aggregation Methods (14+ Available)

Category	Methods	Use When
Social Choice	Majority, Borda, Schulze, Approval	Democratic legitimacy, ranked preferences
Welfare Economics	Maximin, Atkinson	Fairness, inequality aversion, minority protection
Machine Learning	Robust Median, Consensus	Outlier resistance, ensemble predictions
Game Theory	Nash Bargaining, Veto Hybrid	Strategic settings, minority veto power

Full list: Aggregation Methods Documentation

Why Democratic Aggregation?

Problem: Single AI models can be biased, unfair, or make decisions that don't align with diverse human values.

Solution: Democratic aggregation provides:

• ✅ Fairness: Mechanisms with provable properties (anonymity, Pareto efficiency, minority protection)
• ✅ Diversity: Incorporates multiple perspectives systematically
• ✅ Transparency: Clear mathematical procedures, not black-box decisions
• ✅ Robustness: Resistant to outliers and strategic manipulation

🔬 Research & Citations

AgorAI builds on decades of research in social choice theory, welfare economics, and multi-agent AI systems.

Related Research:

• Constitutional AI (Anthropic)
• Multi-agent reinforcement learning (MARL)
• Test-time compute scaling (OpenAI o1)
• Collective decision-making in AI

Citing AgorAI:

@software{agorai2025,
  author = {Schlenker, Samuel},
  title = {AgorAI: Democratic AI Through Multi-Agent Aggregation},
  year = {2025},
  url = {https://github.com/yourusername/agorai}
}

🤝 Contributing

Contributions for research and non-commercial purposes are welcome! See CONTRIBUTING.md for guidelines.

Areas where we'd love help:

• Additional benchmark datasets
• New aggregation mechanisms
• Documentation improvements
• Bug reports and feature requests

📄 License

Research and Non-Commercial License

Copyright (c) 2025 Samuel Schlenker

Free for academic research, education, and non-commercial use. Commercial use requires prior written agreement.

See LICENSE for full terms.

📧 Contact

• Issues: GitHub Issues
• Email: [e-mail]

---

Built with ❤️ for the democratic AI research community