Skip to content

CODEBRAKERBOYY/blackbox-recruiter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎯 BlackBox Recruiter

AI-Powered Resume Analyzer & ATS Optimizer

Live Demo GitHub Stars GitHub Forks

React Vite Tailwind Groq Llama


πŸ“– About

BlackBox Recruiter is an intelligent resume optimization platform that helps job seekers beat Applicant Tracking Systems (ATS) and land more interviews. Powered by Groq's Llama 3.3 70B model, it provides instant AI-driven insights on resume-job compatibility.

πŸ’‘ The Problem

  • 75% of resumes are rejected by ATS before reaching recruiters
  • Job seekers don't know what's missing from their resumes
  • Generic advice doesn't address specific job requirements
  • Manual analysis takes 15+ minutes per application

✨ Features

πŸ€– AI-Powered Analysis - Llama 3.3 70B semantic understanding
πŸ“Š Match Scoring - 0-100% compatibility rating
βœ… Strength Detection - Identifies competitive advantages
⚠️ Gap Analysis - Shows missing qualifications
🎯 ATS Optimizer - Keyword matching & formatting checks
✍️ Rewrite Suggestions - AI-improved bullet points
⚑ Real-Time - Results in under 3 seconds
🎨 Modern UI - Responsive dark theme


πŸš€ Quick Start

Prerequisites

Installation

# Clone repository
git clone https://github.com/CODEBRAKERBOYY/blackbox-recruiter.git
cd blackbox-recruiter

# Install dependencies
npm install

# Create .env file and add your API key
echo "VITE_GROQ_API_KEY=your_groq_api_key_here" > .env

# Start development server
npm run dev

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


🎯 Usage

Match Analysis

  1. Upload resume (TXT/PDF) or paste text
  2. Add job description
  3. Click "Match Analysis"
  4. Get compatibility score, strengths, gaps, recommendations

ATS Optimizer

  1. Same input as above
  2. Click "ATS Optimizer"
  3. Get ATS score, keyword analysis, formatting issues, rewrite suggestions

πŸ› οΈ Tech Stack

Frontend: React 18, Vite, Tailwind CSS, Lucide Icons
AI/LLM: Groq API, Llama 3.3 70B (70 billion parameters)
Deployment: Vercel, GitHub Actions
Version Control: Git, GitHub


πŸ“‚ Project Structure

blackbox-recruiter/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ services/
β”‚   β”‚   └── aiService.js      # Groq API integration & AI logic
β”‚   β”œβ”€β”€ App.jsx               # Main application component
β”‚   β”œβ”€β”€ index.css             # Global styles
β”‚   └── main.jsx              # React entry point
β”œβ”€β”€ .env                      # Environment variables (not in repo)
β”œβ”€β”€ .gitignore                # Git ignore rules
β”œβ”€β”€ package.json              # Dependencies
β”œβ”€β”€ tailwind.config.js        # Tailwind configuration
β”œβ”€β”€ vite.config.js            # Vite configuration
└── README.md                 # This file

🧠 How It Works

AI Analysis Pipeline

User Input β†’ Text Extraction β†’ Prompt Engineering β†’ 
Groq API (Llama 3.3 70B) β†’ JSON Parsing β†’ Display Results

Key Technical Details

Prompt Engineering:

  • Structured prompts for consistent JSON outputs
  • Temperature tuning: 0.5-0.7 for balanced responses
  • Token optimization: 1024-2048 based on analysis type

Error Handling:

  • Graceful fallbacks for API failures
  • Markdown code block removal
  • Input validation

πŸ“ˆ Performance

⚑ Response Time: < 3 seconds
🎯 Accuracy: 85%+ semantic matching
πŸ’° Cost: ~$0.001 per analysis (Groq free tier)
πŸ“¦ Bundle Size: ~450 KB (optimized)


πŸš€ Deployment

Deploy to Vercel

  1. Push to GitHub
  2. Go to vercel.com
  3. Import blackbox-recruiter repository
  4. Add environment variable: VITE_GROQ_API_KEY
  5. Deploy!

Live URL: blackbox-recruiter-f4b4eunb7-aloks-projects-a320deac.vercel.app


🀝 Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create feature branch: git checkout -b feature/amazing-feature
  3. Commit changes: git commit -m 'Add amazing feature'
  4. Push to branch: git push origin feature/amazing-feature
  5. Open Pull Request

πŸ› Issues & Support


πŸ“ License

MIT License - see LICENSE file for details.


πŸ‘¨β€πŸ’» Author

CODEBRAKERBOYY

GitHub


πŸ™ Acknowledgments


⭐ Support

If this project helped you, please give it a ⭐!


Built with ❀️ by CODEBRAKERBOYY

View Demo β€’ Report Bug β€’ Request Feature

About

AI Resume Analyzer & ATS Optimizer

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published