Simulate structured debates between AI agents on any topic, generating persuasive arguments, rebuttals, and judged verdicts.
🚀 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:
-
Clone & Install
git clone https://github.com/aliii-codes/Multi-Agent-Debate-System.git cd Multi-Agent-Debate-System pip install -r requirements.txt -
Set Environment Variables Create a
.envfile:GROQ_API_KEY=your_groq_api_keySign up for Groq to obtain an API key.
-
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 🤝
- Fork the repository
- Create a feature branch:
git checkout -b feature/new-feature - Commit changes:
git commit -m "Add new feature" - Push to branch:
git push origin feature/new-feature - 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