💀 Git-Roast

Git-Roast is a toxic, code-aware terminal-style application that uses Google Gemini AI to brutally analyze and roast GitHub repositories. Featuring a Matrix rain aesthetic and a no-holds-barred attitude, it's the ultimate tool for developers who think their code is too good.

🚀 Features

• Matrix Aesthetic: Immerse yourself in the terminal with a live Matrix rain effect and CLI-style interface.
• Atmospheric Audio: Dynamic background music, entry sounds, and interactive click effects for a fully immersive "hacker" experience.
• Toxic AI Analysis: Powered by Gemini 2.0/Flash (with resilient fallback) to deliver brutal, specific roasts.
• Deep Repo Crawling: Automatically traverses root files and subdirectories (src/, lib/, etc.) to find the "garbage" in your code.
• README Aware: Analyzes documentation to mock your project's architecture and setup.
• Environment Aware: Fully configurable via .env files for seamless deployment.

🛠️ Tech Stack

• Frontend: Astro + React + Vanilla CSS
• Backend: FastAPI + Python 3.10+
• AI: Google Generative AI (Gemini)
• API: GitHub REST API

📦 Installation & Setup

1. Clone the Repository

git clone https://github.com/OmAmberkar/git-roast-v0.0.git
cd git-roast-v0.0

2. Backend Setup (/server)

cd server
python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
pip install -r requirements.txt

• Copy .env.example to .env and add your GEMINI_API_KEY.
• Run the server:

python -m uvicorn main:app --reload --port 8001

3. Frontend Setup (/client)

cd client
npm install

• Copy .env.example to .env. (Defaults to http://127.0.0.1:8001).
• Run the app:

npm run dev

🎮 Usage

1. Open http://localhost:4321 in your browser.
2. Enter a GitHub repository URL (e.g., https://github.com/facebook/react).
3. Press INITIATE_DESTRUCTION.
4. Brace yourself for the truth.

🛡️ License

Distribute your own roasts responsibly.

---

Built for the GDGC Hackathon. 💀🔥