An AI-powered tool that automates the hiring pipeline — from sourcing LinkedIn profiles to scoring candidates and generating personalized outreach — using FastAPI, Groq API, and Google Programmable Search.
✅ Frontend Live: ai-hiring-agent.vercel.app ⚙️ Backend API: Hugging Face Space
- **HTML + CSS **: UI layout & styling
- JavaScript: Interactivity and API communication
- Hosted on Vercel
- FastAPI: RESTful API development
- Python: Core logic, AI integration, data processing
- Hosted on Hugging Face Spaces
- Groq API (with LLaMA 3-70B): Candidate analysis & message generation
- Google Programmable Search Engine (PSE): Sourcing real LinkedIn profiles
- OpenAI Compatible Interface (optional future extension)
- venv: Python virtual environment
- Requests / httpx: API communication
- Regex + Sets: Fast, rule-based scoring system
- Environment Variables (
.env): Secure API key management
- LinkedIn profile discovery using Google PSE
- Optional Groq/LLaMA-based AI profile analysis
- Fallback dummy data when APIs are unavailable
- Fast search mode for lightweight usage
- Weighted rubric: education, experience, company, location, tenure, trajectory
- AI-enhanced scoring for top candidates
- Efficient pattern matching & regex optimization
- Groq API-based outreach message generation
- Customized, context-aware messages
- Copy-to-clipboard enabled
- Modern, mobile-friendly design
- Real-time status indicators & error handling
- Animated cards, loading spinners, and smooth UX
| Component | Link |
|---|---|
| 🌐 Frontend | https://ai-hiring-agent.vercel.app |
| ⚙️ Backend API | https://AMD8-Agent.hf.space |
| 📦 API Docs | OpenAPI /docs |
git clone <repo-url>
cd synapse_project
python -m venv senv
source senv/bin/activate
pip install -r requirements.txt.env file in root:
GOOGLE_API_KEY=your_google_key
GOOGLE_SEARCH_ENGINE_ID=your_engine_id
GROQ_API_KEY=your_groq_keycd backend
python enhanced_main.py
# Open http://localhost:8000/frontend| Endpoint | Method | Description |
|---|---|---|
/search |
POST | AI-powered candidate search |
/score |
POST | Candidate scoring with AI |
/outreach |
POST | Generate personalized outreach |
/full-pipeline |
POST | End-to-end pipeline |
/health |
GET | API health check |
Open API Docs for full details.
Job Description ➝ Search Candidates ➝ Score Profiles ➝ Generate Outreach
⬑─────────────── AI-enhanced via Groq & Google APIs ────────────────⬎
-
Search: Google PSE → LinkedIn profiles → optional AI parsing
-
Score: Keyword + AI-based rubric scoring
-
Outreach: Personalized messaging using candidate-job match
synapse_project/
├── agent.py # LinkedIn search logic
├── scoring.py # Rule-based scoring
├── outreach.py # Outreach generation
├── backend/ # FastAPI server (enhanced_main.py)
├── frontend/ # Web UI (served from Vercel)
├── requirements.txt # Python dependencies
- Fork the repo
- Create a feature branch
- Submit a PR with clear commits
This project is licensed under the MIT License.
Built with ❤️ to accelerate technical hiring.
Let me know if you’d like:
- A badge section (build passing, hosted on Vercel, etc.)
- A GitHub project board
- User docs (e.g. for recruiters using the web interface) and I can help you add that too.