Skip to content

Roast My Stuff" is an AI-powered tool that humorously critiques resumes and project portfolios while providing real, actionable feedback.

Notifications You must be signed in to change notification settings

megh-bari/roast-my-stuff

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🔥 Roast My Stuff - Hackathon Edition 🔥

🚀 Overview

"Roast My Stuff" is an AI-powered tool that humorously critiques resumes and project portfolios while providing real, actionable feedback!

🎯 Features

Upload & Roast – Users upload their resume, GitHub repo, or portfolio link for instant roasting. Humor + Learning – AI mixes witty critiques with real, actionable feedback. Roast Levels – Choose from Mild, Spicy, or Extra Burn 🔥🔥🔥. Leaderboard – Rank resumes from Most Roastable to Most Impressive. Portfolio Checker – Detects outdated links, poor UI, and missing content. Social Sharing – Users can share their roasts on Twitter/X & LinkedIn.

🏆 Why This is a Great Hackathon Project

💡 Unique & Engaging – Blends fun with practicality, making it shareable. 📌 Useful for Developers – Helps users improve their resumes & portfolios. 😂 Memorable – The roasting aspect makes it stand out. 🚀 Scalable – Can expand to cover cover letter reviews, LinkedIn profiles, and interview responses.

🛠 Tech Stack

  • Frontend: React.js, TailwindCSS
  • Backend: Node.js with Express
  • AI: Gemini API
  • Database: Firebase/Supabase

🔧 Installation & Setup

1. Clone the repository:

git clone https://github.com/megh-bari/roast-my-stuff.git
cd roast-my-stuff

2. Setup Frontend

cd frontend
npm install
npm run dev

Open http://localhost:3000 in your browser.

3. Setup Backend

cd backend
npm install
npm run dev

Backend will run on http://localhost:5000 (or configured port).

4. Set up environment variables (e.g., Gemini API key, Firebase config) in .env files for both frontend and backend.

🌟 Show Some Love

If you like this project, give it a ⭐ on GitHub and share it on social media!

About

Roast My Stuff" is an AI-powered tool that humorously critiques resumes and project portfolios while providing real, actionable feedback.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •