Skip to content

README.md

Latest commit

 

History

History
59 lines (42 loc) · 1.55 KB

README.md

File metadata and controls

59 lines (42 loc) · 1.55 KB

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