https://github.com/hallowshaw/vox-debate
VoxDebate is an AI-powered debate platform built on the MERN stack, featuring voice input, real-time sentiment analysis with Hugging Face, and intelligent responses via Google Gemini Pro. With a sleek design using Tailwind CSS and shadcn-ui, it offers a dynamic, responsive, and engaging experience for meaningful discussions.
https://github.com/hallowshaw/vox-debate
ai-debate debate-system genai generative-ai google-gemini-pro googlegemini hubert huggingface huggingface-models javascript mern-project mern-stack mern-stack-app shadcn-ui tailwindcss
Last synced: about 2 months ago
JSON representation
VoxDebate is an AI-powered debate platform built on the MERN stack, featuring voice input, real-time sentiment analysis with Hugging Face, and intelligent responses via Google Gemini Pro. With a sleek design using Tailwind CSS and shadcn-ui, it offers a dynamic, responsive, and engaging experience for meaningful discussions.
- Host: GitHub
- URL: https://github.com/hallowshaw/vox-debate
- Owner: hallowshaw
- License: mit
- Created: 2024-12-21T11:01:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-07T12:58:52.000Z (about 1 year ago)
- Last Synced: 2025-04-07T13:41:16.181Z (about 1 year ago)
- Topics: ai-debate, debate-system, genai, generative-ai, google-gemini-pro, googlegemini, hubert, huggingface, huggingface-models, javascript, mern-project, mern-stack, mern-stack-app, shadcn-ui, tailwindcss
- Language: JavaScript
- Homepage: https://vox-debate.vercel.app/
- Size: 29.9 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# VoxDebate - AI Debate Platform
VoxDebate is an innovative AI-powered debate platform built on the **MERN Stack**. It leverages advanced technologies, including Hugging Face's AI models and Google Gemini Pro, to create a seamless and intelligent debating experience. With its user-friendly interface, VoxDebate transforms the way users engage in meaningful discussions.
---
## 🚀 Features
### 🎙️ Voice Input and Emotion Analysis
- **Voice Recording**: Uses `react-speech-recognition` to record and transcribe speech in real-time.
- **Emotion Detection**: Integrates Hugging Face's [HuBERT Large Model](https://api-inference.huggingface.co/models/superb/hubert-large-superb-er) for voice sentiment analysis.
- **Emotion Display**: Displays the detected emotion alongside the AI's response.
### 📝 Real-Time Text Editing
- Users can edit the transcribed text before sending it to the AI for more precise interactions.
### 💬 Vox Debate Playground
- A chat-like interface designed for dynamic, engaging conversations with AI.
- Powered by **Google Gemini Pro** for intelligent and context-aware responses.
### 🌗 Dark and Light Mode
- Seamless integration using Redux Toolkit.
### 🎨 Responsive and Beautiful Design
- Built with **Tailwind CSS** and **shadcn-ui** for a polished user experience.
- Smooth transitions and animations powered by `framer-motion`.
### 🔒 Secure and Scalable Backend
- **User Authentication**: Managed using Context API and `jsonwebtoken`.
- **File Handling**: `multer` is used for handling uploads.
- **Database**: MongoDB and Mongoose provide robust data management.
### 📢 Notifications
- Instant feedback with `react-toastify`.
---
## 🛠️ Installation
1. Clone the repository:
```bash
git clone https://github.com/hallowshaw/VoxDebate.git
```
2. Navigate to the project directory:
```bash
cd VoxDebate
```
3. Install dependencies:
- Frontend
```
cd Frontend
npm install
npm i framer-motion lucide-react react react-dom react-icons react-redux react-router-dom react-speech-recognition react-toastify wav-encoder
```
- Backend
```
cd Backend
npm install
npm i @google/generative-ai axios bcrypt concurrently cookie-parser cors dotenv express jsonwebtoken mongodb mongoose multer nodemon prettier
```
4. Set up environment variables:
- Create a .env file in the backend directory and replace with actual values
```
PORT=8000
MONGODB_URI=
ACCESS_TOKEN_SECRET=
ACCESS_TOKEN_EXPIRY=
REFRESH_TOKEN_SECRET=
REFRESH_TOKEN_EXPIRY=
CORS_ORIGIN=*
GOOGLE_API_KEY=
HUGGINGFACE_API_KEY=
```
5. Run the application:
- Frontend
```
npm run dev
```
- Backend
```
npm run server
```
- Use concurrently - for both Backend and Frontend
```
cd Backend
npm run dev
```
## 🖼️ Screenshots
Below are some screenshots of the application showcasing its features:
### Vox Debate Playground
### Homepage - Dark Mode
### Homepage - Light Mode
### Login Page
### Signup Page
## 🤝 Contribution
We welcome contributions! Please follow these steps:
1. Fork the repository.
2. Create a new branch:
```bash
git checkout -b feature-name
```
3. Make your changes and commit them:
```
git commit -m "Add feature-name"
```
4. Push your branch:
```
git push origin feature-name
```
5. Open a Pull Request.
We’ll review your changes and merge them if everything checks out!
## 📄 License
This project is licensed under the **MIT License**.
Feel free to use it, modify it, and share it while giving credit to the original creators.
For more details, please see the [LICENSE](LICENSE) file.
---
## 🌟 Acknowledgments
A big thank you to:
- **Hugging Face** for their powerful AI models, which have been integrated for sentiment analysis.
- **Google** for providing the Gemini Pro model, which powers the intelligent responses in the debate platform.
- The open-source community for their amazing tools and libraries, which have made this project possible.
Thank you to everyone who contributes and helps make this project better. 🙏