AI Recruitment & ATS Documentation

Complete guide for installing, configuring, and using the AI-powered recruitment system for Odoo 19.0.

Requirements

System Requirements

• Odoo Version: 19.0
• Python: 3.8 or higher
• Database: PostgreSQL 12+
• RAM: Minimum 4GB (8GB recommended)
• Storage: 500MB free space

Dependencies

• Required Odoo Modules:
  • hr_recruitment (built-in)
• Python Packages:
  • openai - OpenAI Python SDK

External Services

• OpenAI API Key: Required for AI features
  • Get your API key from: platform.openai.com
  • Estimated cost: $0.01-0.05 per candidate screening

Installation

Method 1: From Odoo Apps Store (Recommended)

Method 2: From GitHub

# Clone the repository
git clone https://github.com/cervantes79/odoo-ai_recruitment_ats.git -b 19.0

# Move to Odoo addons directory
cp -r odoo-ai_recruitment_ats/ai_recruitment_ats /path/to/odoo/addons/

# Restart Odoo
sudo systemctl restart odoo

# Update Apps List in Odoo UI
# Then install "AI Recruitment & ATS"

Method 3: Install Python Dependencies

# Install required Python packages
pip3 install openai

# Or using requirements file
cd /path/to/odoo/addons/ai_recruitment_ats
pip3 install -r requirements.txt

Verify Installation

# Check module is installed
# Go to: Settings → Apps → Installed Apps
# Search: "AI Recruitment"
# Status should show: "Installed"

Configuration

Step 1: Enable AI Features

1. Go to Settings → General Settings
2. Scroll to AI Recruitment section
3. Check ✓ Enable AI Features
4. Click Save

Step 2: Configure OpenAI API

1. Get your OpenAI API key from platform.openai.com/api-keys
2. In Odoo, go to Settings → General Settings → AI Recruitment
3. Paste your API key in OpenAI API Key field
4. Select AI Model:
   • GPT-5 (2025-08-07) - Best results (recommended)
   • GPT-5 Mini - Fast and efficient
   • GPT-4.1 Mini - Balanced performance
   • GPT-5 Nano - Ultra fast
5. Click Save

Step 3: Configure Access Rights

1. Go to Settings → Users & Companies → Users
2. Select a user
3. In Access Rights tab:
   • Officer: Can use AI features
   • Manager: Can use AI features + manage settings

Usage Guide

1. Create Job Position

1. Go to Recruitment → Job Positions → Create
2. Fill in:
   • Job Title: e.g., "Senior Python Developer"
   • Description: Job overview and responsibilities
   • Requirements: Detailed qualifications

     Required Qualifications:
     - 5+ years of Python development
     - Strong knowledge of Django or Flask
     - Experience with PostgreSQL
     - Git version control proficiency

   • Experience Level: Entry / Junior / Mid / Senior / Lead / Executive
   • Skills Required: Python, Django, PostgreSQL, Docker, Git
3. Click Save

2. Add Applicant

1. Go to Recruitment → Applications → Create
2. Fill in basic info:
   • Applicant Name: John Smith
   • Email: john.smith@email.com
   • Phone: +1 (555) 123-4567
   • Applied Job: Select the job position
3. Upload Resume:
   • Click Attach File
   • Supported formats: PDF, DOC, DOCX, TXT
4. (Optional) LinkedIn Profile: https://linkedin.com/in/johnsmith
5. Click Save

3. Parse Resume (AI)

1. Open the applicant record
2. Click [Parse Resume] button in header
3. AI will automatically extract:
   • Name, email, phone
   • Work experience
   • Education
   • Skills
   • LinkedIn profile
4. Page auto-refreshes with results
5. View results in "Resume Parsing Results" tab

4. Screen Candidate (AI)

1. Open the applicant record
2. Make sure job position is selected
3. Click [Screen Candidate] button
4. AI evaluates candidate against job requirements:
   • AI Score: 0-100 rating
   • Recommendation: Strong Match / Good Match / Maybe / Not Suitable
   • Strengths: Key positive points
   • Concerns: Potential issues or gaps
   • Interview Questions: 5 personalized questions
5. Page auto-refreshes with results
6. View results in "AI Screening Results" tab

5. Review AI Results

1. Go to applicant form
2. Check AI Score (progress bar)
3. Check AI Recommendation (badge)
4. Read Strengths and Concerns
5. Use AI Suggested Interview Questions in interviews

6. Compare Candidates

1. Go to Recruitment → Applications
2. View AI Score and AI Recommendation columns
3. Sort by AI Score (highest first)
4. Filter by recommendation level
5. Select top candidates for interviews

Frequently Asked Questions

Troubleshooting

Issue: "AI features are not enabled"

Issue: "OpenAI API key is not configured"

Issue: "No resume file found"

Issue: "AI screening failed"

Issue: Page doesn't auto-refresh

Support