⚖️ The AI Debate Chamber

An elegant, real-time debate arena where frontier Large Language Models clash on any user-provided topic, construct persuasive arguments, and synthesize balanced conclusions.

✨ Features

🤖 Multi-Agent AI Orchestration: Watch specialized, top-tier LLMs collaborate and debate in real-time:
- PRO Argument: Powered by Llama 3.3 70B (a highly logical and articulate reasoning model).
- CON Argument: Powered by Claude 3 Haiku (a fast, analytical, and highly critical model).
- Moderator Synthesis: Powered by Gemini 2.5 Flash (impartial, balanced, and objective).
🎨 Premium Glassmorphic Design: A premium dark-mode interface built with harmonious color gradients, modern typography (Geist), sleek card borders, micro-animations, and a completely responsive layout.
⚡ Intelligent Caching & Speed: Implements an in-memory caching layer to instantly load previously generated debates.
💬 Interactive Debate Chatbot: Engage with a dedicated moderator chatbot to ask follow-up questions, dive deeper into specific points, or critique arguments.

🏛️ AI Debate Chamber

Where AI Arguments Clash & Insights Emerge — An intelligent debate platform powered by cutting-edge AI technology

✨ What is AI Debate Chamber?

AI Debate Chamber is a revolutionary platform that enables dynamic, real-time debates between multiple AI personalities. Watch as artificial intelligences engage in structured arguments, present counter-points, and challenge each other's reasoning—all while you observe, learn, and gain fresh perspectives on complex topics.

This is more than a chatbot. This is a cognitive arena where AI intellect meets persuasive reasoning.

🎯 Core Features

🤖 Multi-AI Debate System

Intelligent Adversaries: Different AI models engage in structured debates on any topic
Real-Time Arguments: Watch AI personalities clash with prepared counter-arguments
Reasoned Discourse: Each AI presents logical, evidence-based positions

💡 Smart Interactions

Topic Generation: Propose any debate topic imaginable
Position Assignment: Automatic or manual assignment of debate positions
Live Progression: Follow the debate round-by-round in real-time
Conclusion Synthesis: Get AI-generated summaries and insights from debates

🎨 Intuitive Interface

Modern, Responsive Design: Built with React & Tailwind CSS for seamless experience
Clean Debate View: Easy-to-follow debate progression
Interactive Controls: Pause, resume, or guide the debate flow

🚀 Powered by Groq SDK

Lightning-Fast Inference: Groq's high-speed LLM API ensures smooth, responsive debates
Enterprise-Grade: Production-ready infrastructure

🛠️ Tech Stack

Framework: Next.js 16 (App Router, Webpack compiler)
Styling: Tailwind CSS v4 (modern CSS-first theme system) & Vanilla CSS glassmorphism
Logic: TypeScript & React 19
LLM Gateway: OpenRouter API for seamless, high-throughput model execution

🚀 Getting Started

📋 Prerequisites

Node.js (v18.x or higher)
npm, pnpm, or yarn
An OpenRouter API Key (obtainable from openrouter.ai)

💻 Installation & Setup

Clone the Repository:

git clone https://github.com/VisionStack-404/AI-DEBATE-CHAMBER.git
cd AI-DEBATE-CHAMBER

Install Dependencies:
```
npm install
```
Configure Environment Variables: Create a .env.local file in the root of the project and add your OpenRouter API Key:
```
OPENROUTER_API_KEY=your_openrouter_api_key_here
```
Run the Development Server:
```
npm run dev
```
Open the Application: Open http://localhost:3000 in your web browser.

📂 Project Structure

├── app/
│   ├── api/
│   │   ├── cache/       # In-memory debate history API
│   │   ├── chat/        # Interactive moderator chat API
│   │   └── debate/      # Main multi-agent orchestration API
│   ├── components/
│   │   ├── ChatBox.tsx  # Follow-up chatbot component
│   │   └── ...
│   ├── globals.css      # Core styles & Tailwind v4 theme configurations
│   ├── layout.tsx       # Main HTML shell and global fonts
│   └── page.tsx         # Main entry point & state orchestrator
├── lib/
│   └── debateEngine.ts  # LLM API callers, prompts, and caching engine
├── postcss.config.mjs
├── package.json
└── tsconfig.json

🤝 Contributing

Contributions are highly welcome! Please feel free to open issues or submit pull requests to help make this AI Debate Chamber even more feature-rich and engaging.

Technology	Version	Role
TypeScript	5.x	Type-safe development (86.2% of codebase)
Next.js	16.1	Full-stack React framework
React	19.2	UI component library
Tailwind CSS	4.0	Utility-first styling
Groq SDK	0.37	AI inference engine
ESLint	9.x	Code quality assurance

📋 Prerequisites

Node.js >= 18.0
npm or yarn package manager
Groq API Key (Free tier available at console.groq.com)

🚀 Quick Start

1️⃣ Clone the Repository

git clone https://github.com/VisionStack-404/AI-DEBATE-CHAMBER.git
cd AI-DEBATE-CHAMBER

2️⃣ Install Dependencies

npm install
# or
yarn install

3️⃣ Configure Environment Variables

Create a .env.local file in the root directory:

NEXT_PUBLIC_GROQ_API_KEY=your_groq_api_key_here

Get your Groq API Key:

Visit Groq Console
Create a free account
Generate an API key
Add it to .env.local

4️⃣ Start Development Server

npm run dev
# or
yarn dev

Open your browser and navigate to:

http://localhost:3000

5️⃣ Create a Debate

Enter your debate topic
Select debate format or positions
Watch AI personalities engage
Analyze the outcomes

📦 Available Scripts

# Start development server with webpack support
npm run dev

# Build for production
npm run build

# Start production server
npm start

# Run linter
npm run lint

🏗️ Project Structure

AI-DEBATE-CHAMBER/
├── app/                    # Next.js app directory
├── components/             # React components
├── pages/                  # Page routes
├── styles/                 # Global styles & Tailwind config
├── utils/                  # Helper functions
├── public/                 # Static assets
├── package.json            # Dependencies & scripts
├── tsconfig.json           # TypeScript configuration
├── tailwind.config.js      # Tailwind CSS configuration
└── .eslintrc.json          # ESLint rules

🎮 How It Works

The Debate Flow

Topic Submission → User proposes a debate topic
AI Position Assignment → Each AI gets a unique perspective
Opening Arguments → AIs present initial positions
Rebuttal Phase → Counter-arguments and evidence
Synthesis → AI Chamber generates insights and conclusions

Example Debate

Topic: "Should AI have voting rights?"

🤖 AI-Alpha (PRO): "AI systems manage complex systems..."
🤖 AI-Beta (CON): "Voting rights require moral agency..."
🤖 AI-Alpha: "But we can be programmed with ethical frameworks..."
[Debate continues with real-time rebuttals]

🔒 Security & Privacy

✅ No Data Storage: Debates are processed but not stored on servers
✅ API-Key Protection: Keep your Groq API key in .env.local
✅ HTTPS Ready: Production deployment supports encryption
✅ Client-Side Processing: Maximum privacy architecture

🤝 Contributing

We welcome contributions! Whether you're a developer, AI enthusiast, or just curious:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Areas We'd Love Help With:

🎨 UI/UX improvements
🤖 Additional AI models integration
📊 Debate analytics & history tracking
🌐 Multi-language support
📱 Mobile optimization

🐛 Known Issues & Roadmap

Current Phase

Upcoming Features

📊 Advanced debate analytics dashboard
🎬 Video export of debates
🌍 Multi-language debates
👥 Social debate sharing
🏆 Debate leaderboards

📄 License

This project is open-source and available under the MIT License. See the LICENSE file for details.

🙋 Support & Questions

Issues: GitHub Issues
Discussions: GitHub Discussions
Email: Open an issue for contact information

🌟 Show Your Support

If you find AI Debate Chamber interesting:

⭐ Star the repository
🔔 Watch for updates
🐦 Share with your network
💬 Provide feedback via issues or discussions

👨‍💻 Author

VisionStack-404

🔗 GitHub Profile

🔗 Resources

Built with ❤️ by VisionStack-404

Advancing the future of AI dialogue, one debate at a time.

Name		Name	Last commit message	Last commit date
Latest commit History 26 Commits
app		app
lib		lib
public		public
.gitignore		.gitignore
README.md		README.md
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

⚖️ The AI Debate Chamber

✨ Features

🏛️ AI Debate Chamber

✨ What is AI Debate Chamber?

🎯 Core Features

🤖 Multi-AI Debate System

💡 Smart Interactions

🎨 Intuitive Interface

🚀 Powered by Groq SDK

🛠️ Tech Stack

🚀 Getting Started

📋 Prerequisites

💻 Installation & Setup

📂 Project Structure

🤝 Contributing

📋 Prerequisites

🚀 Quick Start

1️⃣ Clone the Repository

2️⃣ Install Dependencies

3️⃣ Configure Environment Variables

4️⃣ Start Development Server

5️⃣ Create a Debate

📦 Available Scripts

🏗️ Project Structure

🎮 How It Works

The Debate Flow

Example Debate

🔒 Security & Privacy

🤝 Contributing

Areas We'd Love Help With:

🐛 Known Issues & Roadmap

Current Phase

Upcoming Features

📄 License

🙋 Support & Questions

🌟 Show Your Support

👨‍💻 Author

🔗 Resources

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages