AI CV Screening for Odoo 19 Community Recruitment documentation
A guide to AI CV screening: connecting the AI, writing what you look for, screening one or many applicants, privacy and fairness, and the access rights.
Documents version 1.0.0Updated Oct 24, 2026
Start here
In plain words: A job post brings in sixty CVs and a recruiter has an afternoon. AI CV Screening reads the CV attached to each applicant and compares it with what you look for in the job, which you write once. You get a score from 0 to 100, a recommendation (strong, possible or weak match), a summary, the skills, the years of experience, the strengths, the gaps and interview questions to check the gaps. The name and the contact details are hidden from the AI, and the decision stays yours.
Important: The score is advice, not a decision. Never reject a candidate on the score alone: read the CV, and keep your hiring process fair and lawful.
What you get
| Feature | What it does |
|---|---|
| Requirements per job | A field What we look for on each job (must have, nice to have). Empty: the job description is used. |
| Screening | Score, recommendation, summary, skills, years of experience, strengths, gaps. |
| Interview questions | Up to five questions based on the gaps. |
| Name and contact hidden | The name, email and phone of the candidate are removed from the CV before it is sent (a company option, on by default). |
| Fair by instruction | The AI is told to ignore gender, age, nationality, religion, marital status, photo and address, and not to mention them. |
| One or many | A button on the applicant; an action on the list (20 at a time). |
| Sort and filter | AI score column, filters strong match and not screened. |
| Chatter | A note on the applicant records each screening. |
| Arabic | Everything is translated and works right to left; CVs can be in Arabic. |
Requirements
| Item | Details |
|---|---|
| Odoo | 19.0 (Community or Enterprise) |
| Apps needed | Recruitment (hr_recruitment) |
| AI Connector | taqnix_ai_connector, included in the package |
| An AI provider | An account and an API key with an OpenAI-compatible service or with Anthropic, or a model on your own server. You pay your provider for what you use. |
| License | OPL-1 (Odoo Proprietary License v1.0) |
Install
- Unzip the package. Inside are
taqnix_ai_connector.zipandtaqnix_ai_cv_screening.zip; unzip them to get the two folders. - Copy the folders into one of the
addons_pathfolders of your Odoo server and restart Odoo. - Log in as an administrator, activate Developer mode, open Apps and press Update Apps List.
- Remove the “Apps” filter, search AI CV Screening and press Install. The AI Connector is installed with it.
# or from the command line ./odoo-bin -c odoo.conf -d YOUR_DATABASE -i taqnix_ai_cv_screening --stop-after-init
Connect your AI provider
In plain words: Before the first use, an administrator connects Odoo to an AI model: Settings → AI → Providers → New. Choose the type (an OpenAI-compatible service or Anthropic), the API address, your API key and the model name as your provider writes it, then press Test the connection. A model on your own server works too: leave the key empty.
| Field | Meaning |
|---|---|
| Type | OpenAI-compatible (chat completions) or Anthropic (Messages API). |
| API address | For OpenAI-compatible services the address up to /v1; for Anthropic https://api.anthropic.com. |
| API key | Kept in the database; only administrators can read it. |
| Model | The model name, for example the one your provider recommends for text. |
Tip: Members of the group Can use the AI features see the AI buttons: all the internal users get it when the connector is installed, and an administrator can take it away.
Write what you look for
In plain words: Open a job position (Recruitment → Configuration → Job Positions, or the job form) and fill the AI screening tab, What we look for: the skills, the years of experience, the languages, the education; what is a must and what is a plus. The more precise, the more useful the screening.
Screen an applicant
In plain words: Attach the CV (a PDF with text) to the applicant, or paste it in the notes, and press Screen with AI. The AI screening tab fills in.
Important: A PDF that is only a scan has no text. Paste the text of the CV in the notes instead.
Screen many applicants
In plain words: In the applicants list select the rows and choose Action → Screen with AI (20 at a time). The list shows the AI score and recommendation, and the filters AI: strong match and AI: not screened help you work through a large pile. If one applicant cannot be screened (no CV, no job), the others still are, and you are told which.
Privacy and fairness
In plain words: A CV is personal data. Before it is sent to your provider the name, the email and the phone of the candidate are replaced (switch this off in the company, AI tab, if you must). The AI is also asked to ignore gender, age, nationality, religion, marital status, photo and address. This reduces, but does not remove, the risk of bias or of a leak: a CV can mention other personal details.
In plain words: Using an AI model means sending text to your provider. Screening sends the text of the CV and the requirements of the job. Before any text leaves Odoo, emails, phone numbers, IBANs and long numbers are masked (a company option, on by default). The usage log keeps the figures only (who, which feature, how many tokens, the estimated cost); it keeps the content of the requests only if you switch that on. A monthly token budget stops the features when it is used up.
Important: AI can be wrong. Treat what it writes as a draft: read it before you send it, save it or act on it.
Important: Check what the law and your own policy require before you use AI to screen candidates (information to candidates, a human decision, records). Keep the final decision human.
Who can do what
| Who | Can |
|---|---|
| Members of Can use the AI features | Screen the applicants they can edit; see the AI screening tab. |
| AI administrators | Connect the AI and see the usage. |
| Other users | Do not see the AI tab. |
Arabic and right to left
Limits
| Limit | Detail |
|---|---|
| Advice only | The module never changes the stage of an applicant or rejects anyone. |
| Only the CV | The AI sees the text of the CV and the requirements: not interviews, tests or references. |
| Scans | A PDF without text cannot be read. |
| 20 per run | Run the action again for the rest. |
| Bias | AI models can carry biases. Treat the score as one input among others. |
For developers
In plain words: Skip this chapter if you only use the module.
job = env['hr.job'].browse(job_id)
job.ai_requirements = 'Must have: 3+ years of accounting, IFRS, Arabic and English.'
applicants = env['hr.applicant'].search([('job_id', '=', job.id), ('ai_screened_on', '=', False)], limit=20)
applicants.action_ai_screen()
for a in applicants:
print(a.partner_name, a.ai_score, a.ai_recommendation, a.ai_gaps)Troubleshooting
| Problem | What to do |
|---|---|
| There is no readable CV | Attach a PDF with text, or paste the CV in the notes. |
| Choose the job position first | The applicant has no job: the CV is compared with the job. |
| Write what you look for | The job has no requirements and no description: fill What we look for. |
| No Screen with AI button | You are not in the group Can use the AI features. |
Updating and removing
Replace the folder with the new version, restart Odoo and run -u taqnix_ai_cv_screening. The screenings stay on the applicants.
Support
Installation help and bug fixes are included for 6 months, with lifetime updates. Contact us through the marketplace page where you bought the module or write to support@taqnix.com with your Odoo version and a screenshot.