Skip to content

madhavcodez/reverserecruiter

Repository files navigation

ReverseRecruiter

AI-powered reverse recruiting agent — autonomous job research, contact discovery, and outbound cold calling. Your always-on career co-pilot.

What It Does

ReverseRecruiter flips the job search. Instead of you applying to companies, it:

  1. Researches companies and roles that match your profile
  2. Discovers hiring managers and decision-makers via web + API search
  3. Cold calls businesses directly using AI voice (Pipecat + Gemini Live + Twilio)
  4. Qualifies opportunities based on your criteria
  5. Reports findings with confidence scores and source citations

Tech Stack

  • Backend: FastAPI, SQLAlchemy, Celery, PostgreSQL, Redis, Qdrant
  • Frontend: Next.js 14, React 18, Tailwind CSS
  • Voice: Pipecat + Gemini Live + Twilio
  • LLM: Google Gemini 2.5 Flash
  • Search: Exa API, Google Search

Architecture

Service Port Description
Dashboard 3000 Next.js 14 frontend
Backend 8000 FastAPI REST API
Celery Worker Async task execution
PostgreSQL 5432 Primary database
Redis 6379 Cache, queues, pub/sub
Qdrant 6333 Vector embeddings

Quick Start

cp .env.example .env
# Add your API keys (GEMINI_API_KEY, TWILIO_*, EXA_API_KEY)

docker compose up -d
docker compose exec backend alembic upgrade head

# Open http://localhost:3000

Development

# Backend
cd backend && pip install -r requirements.txt
uvicorn app.main:app --reload

# Frontend
cd dashboard && npm install && npm run dev

License

MIT

About

AI-powered reverse recruiting agent — autonomous job research, contact discovery, and outbound cold calling. Your always-on career co-pilot.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors