Skip to content

aliii-codes/Multi-Agent-Debate-System

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Multi-Agent Debate System 🗣️

Simulate structured debates between AI agents on any topic, generating persuasive arguments, rebuttals, and judged verdicts.

GitHub stars GitHub forks GitHub issues License

Python CrewAI Groq Rich


🚀 New in v1.1:

  • Enhanced Terminal UI 🎨: Richer debate visualization with live updates
  • Improved Argument Structure 💬: Sharper rebuttals and closing arguments
  • Faster Response Times ⚡: Optimized LLM parameters for quicker debates

Feature Description
Structured Debates 🏛️ 3-round debates with opening, rebuttals, and closing arguments
Multi-Perspective 🌐 Supports pro/con, AI vs human, and custom debate formats
AI Judging ⚖️ Impartial evaluation with logic/evidence/attack scoring
Terminal UI 🎮 Interactive debate visualization (optional)
Customizable 🛠️ Easily modify agents, structure, and LLM parameters

Category Technologies
Core Framework Python, CrewAI
LLM Provider Groq (Llama 3 models)
UI (optional) Rich
Environment dotenv

Get started in 3 steps:

  1. Clone & Install

    git clone https://github.com/aliii-codes/Multi-Agent-Debate-System.git
    cd Multi-Agent-Debate-System
    pip install -r requirements.txt
  2. Set Environment Variables Create a .env file:

    GROQ_API_KEY=your_groq_api_key
    

    Sign up for Groq to obtain an API key.

  3. Run a Debate

    # Basic CLI version
    python full_debate.py
    
    # Terminal UI version
    python terminal_ui_by_claude.py

Project Structure

├── basic_architecture.py  # Core debate logic
├── full_debate.py         # Complete debate implementation
└── terminal_ui_by_claude.py # Terminal UI version

Contributing 🤝

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/new-feature
  3. Commit changes: git commit -m "Add new feature"
  4. Push to branch: git push origin feature/new-feature
  5. Open a pull request

Report Issues 🐛 Open an issue with:

  • Error description
  • Steps to reproduce
  • Expected behavior

License This project is licensed under the MIT License.

Acknowledgements

  • CrewAI for agent management
  • Groq for LLM inference
  • Rich for terminal UI components

About

A multi-agent debate system built with CrewAI and Groq, featuring 3 debate rounds, aggressive AI-powered debaters, and a judge agent that scores and declares a winner. Rich terminal UI for clean output.

Resources

License

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages