Freddie AI Recruiter

Freddie AI Recruiter is an automated backend recruitment pipeline that integrates Google Services and OpenAI API for candidate ranking and communication.

Features

• Candidate data retrieval from Google Sheets
• Resume and screening answer processing
• Candidate ranking via OpenAI
• Results storage
• Candidate email communication

Installation 🛠️

1. Clone from GitHub

   git clone https://github.com/stevo1403/alpharithm

2. Install dependencies

   poetry install

3. Add critical environment variables to .env file(in project root dir)

   GOOGLE_SERVICE_ACCOUNT_CREDENTIALS=<path-to-service-account-creds.json>
   OPENAI_API_KEY=<your-openai-api-key>
   CANDIDATE_SHEET_URL=<url-to-candidate-sheet>

Usage 🚀

1. Run the app

   poetry run python app.py

2. Open the browser and browse to Rankings

   http://localhost:5000/app/rankings
   

OpenAI Prompt ✍️

Freddie AI Recruiter uses the following OpenAI prompt to rank candidates:

You are a professional recruiter.

Provide a score from 0-100 with a brief justification.
Return only the numerical score.

Rate this candidate's fit for a marketing officer role. 
Consider experience, skills, and cultural fit.

Resume:
<resume_text-here>

Screening Questions:
Question: <screening-question-1-here>
Answer: <screening-answer-1-here>

Question: <screening-question-2-here>
Answer: <screening-answer-2-here>

This prompt ensures consistent and fair evaluation of candidates.

API routes 📡

APP Host: API Host

Base API Path: /api/v1/

The following endpoints are available for consumption:

Method	Route
GET	/rankings
GET	/questions
GET	/rankings/summary

Base APP Path: /app

The following endpoints are available for consumption:

Method	Route
GET	/rankings