Group Chat Roaster

A brutal, unfiltered AI-powered behavioral analysis tool for your WhatsApp group chats. Upload your chat history and let the AI roast your group's communication style, archetypes, and chaotic energy.

---

Features

• Unfiltered Analysis — Deep insights into your group's true dynamics
• Archetype Identification — Discover who is the Chaos Agent, the Ghost, or the Group Mom
• Communication Insights — Brutally honest feedback on response times and personality quirks
• Privacy First — Chat logs are processed locally and only sent to the AI for analysis

---

🛠 Tech Stack

Layer	Technology
Backend	Node.js, Express
AI Model	Google Gemini (@google/generative-ai)
Frontend	Vanilla HTML / CSS / JS
File Handling	Multer

---

Prerequisites

• Node.js installed on your machine
• A Google Gemini API Key from Google AI Studio

---

Installation

1. Clone the repository

   git clone https://github.com/Shikhar-2005/chat-roaster.git
   cd chat-roaster

2. Install dependencies

   npm install

3. Configure your API Key

   Create a .env file in the root directory:

   GEMINI_API_KEY=your_actual_api_key_here
   

4. Run the server

   node server.js

5. Open in browser

   Navigate to http://localhost:3000 and start roasting!

---

Project Structure

chat-roaster/
├── server.js         # Express backend + Gemini API integration
├── public/           # Frontend HTML, CSS, JS
├── uploads/          # Temporary chat file storage (auto-cleared)
├── .env              # Your secret API key (never push this!)
├── .gitignore        # Keeps .env off GitHub
└── package.json

---

Important

Never commit your .env file to GitHub.
API keys are private credentials. This project's .gitignore excludes .env by default — but always verify before pushing, especially on new machines or forks.

---

License

This project is open-source. Feel free to fork it, roast your friends, and make it even more savage.

---