Summary

This Python script automates the critical task of matching resumes to job descriptions using advanced AI, targeting recruiters and hiring managers. It streamlines candidate evaluation by leveraging either Anthropic Claude or OpenAI GPT APIs for intelligent analysis, scoring, and personalized communication. The primary benefit is an efficient, data-driven approach to identifying top candidates, complete with detailed scoring, automated outreach, and standardized output formats, significantly reducing manual effort in the recruitment pipeline.

How It Works

The core of the project is a Python script that processes resume PDFs and a job description text file. It employs AI models (Anthropic Claude or OpenAI GPT) to compare resume content against job requirements, generating a match score. A unique scoring methodology combines an AI-generated match score (75% weight) with a resume quality score (25% weight), assessing both content relevance and visual presentation for a holistic evaluation. The system supports dual AI providers, allowing runtime selection, and offers efficient model interaction with structured data handling. Outputs include standardized resumes in PDF or Markdown, alongside personalized email responses for candidates.

Quick Start & Requirements

Installation is managed via pip: pip install PyPDF2 anthropic openai tqdm termcolor json5 requests beautifulsoup4 pydantic. To run, execute python resume_matcher.py with optional arguments for font presets (--sans-serif, --serif, --mono) and PDF generation (--pdf), followed by paths for the job description file and PDF output folder. Key prerequisites include setting the CLAUDE_API_KEY environment variable (or configuring for OpenAI) and placing resume PDFs in the default src directory.

Highlighted Details

• AI-powered resume-job comparison using Anthropic Claude or OpenAI GPT APIs, with runtime model selection.
• Dual-factor scoring: 75% AI Match Score (content relevance) + 25% Resume Quality Score (visual appeal and clarity).
• Red flag detection in critical resume areas for proactive risk assessment.
• Automated generation of unified resumes (PDF/Markdown) and personalized candidate emails.
• Comprehensive analytics, including statistical insights, candidate distribution summaries, and match improvement suggestions.
• Optional website integration for enhanced candidate profiling.

Maintenance & Community

The project encourages contributions via pull requests, outlining a standard contribution workflow. Specific community channels (e.g., Discord, Slack), roadmaps, or notable maintainers are not detailed in the provided README.

Licensing & Compatibility

The README does not specify a software license. Users should verify licensing terms before adoption, especially for commercial use or integration into proprietary systems, as compatibility is undetermined.

Limitations & Caveats

Operation requires valid API keys for either Anthropic Claude or OpenAI. The script relies on specific input file locations (e.g., resumes in src/) and may encounter network-related errors (timeouts, rate limits) when fetching external website content. Users are responsible for ensuring compliance with data privacy regulations when handling candidate information.