Smart Resume Parser and Job Matcher

A Django application that integrates with OpenAI to provide two main features:

1. Resume Parser: Extracts details from uploaded resume files and saves them to the database.
2. Job Matcher: Analyzes a user's resume data against a job description and returns a matching score and a brief description.

Features

• Resume Parsing: Upload a resume in PDF format, and the application extracts and stores relevant details such as qualifications, experience, skills, and social profiles.
• Job Matching: Matches the extracted resume data against a job description and returns a percentage score indicating how well the candidate fits the job, along with a brief explanation.

Installation

1. Clone the repository:

   git clone [email protected]:abdullahmujahidali/ResumeParser-JobMatcher.git
   cd SmartResumeJobMatcher

2. Set up a virtual environment:

   python -m venv myenv
   source myenv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt

4. Set up environment variables for OpenAI API key and other settings. Create a .env file in the project root with the following content:

   OPENAI_API_KEY=your_openai_api_key
   OPENAI_PARSER_ASSISTANT_ID=your_parser_assistant_id
   OPENAI_JOB_MATCHER_ASSISTANT_ID=your_job_matcher_assistant_id

5. Apply migrations and start the server:

   python manage.py migrate
   python manage.py runserver

Usage

Resume Parser

Endpoint: /assistant/resume-parser/

Send a POST request to this endpoint with the resume file to parse and store the extracted details.

Input Data:

• resume (FileField)

Output:

{
    "message": "Resume parsed and saved successfully",
    "user_id": "e6cf8c90-6685-4843-8ea2-97ab728ec5e6",
    "content": {
        "first_name": "Abdullah",
        "last_name": "Mujahid",
        "email": "[email protected]",
        "phone_number": "+923229437619",
        "location": "Lahore, Pakistan",
        "socials": ["Linkedin", "Github", "Google Scholar", "Portfolio"],
        "qualifications": [
            {
                "university": "University of Management & Technology",
                "degree": "Bachelor",
                "institute": "Lahore Pakistan",
                "grade_type": "4.0",
                "grade": 3.57,
                "start": "August 2017",
                "end": "May 2021",
                "major": "Computer Science"
            }
        ],
        "experience": [...],
        "skills": [...],
        "projects": [...]
    }
}

Job Matcher

Endpoint: /assistant/job-matcher/

Send a POST request to this endpoint to match the user's resume data against a job description and get the matching score and description.

Input Data:

{
    "resume_data": { ... },
    "job_description": "Job brief ..."
}

Output:

{
    "score": 90,
    "description": "Abdullah Mujahid is an excellent fit for the Web Developer position based on the provided job description. His experience as a Senior Full Stack Software Engineer and Development Lead aligns well with the responsibilities of building websites from concept to completion. Abdullah's proficiency in Django, React.js, and Agile methodologies, as well as his strong background in HTML/CSS and familiarity with JavaScript, reinforces his coding and design capabilities. His involvement in web development projects like 'Gladiator Finance - NFT Marketplace' and 'BigBrains - E-learning Platform' highlights his ability to integrate data from back-end services and develop robust web applications. Additionally, his solid understanding of programming languages, network diagnostics, and SEO further supports his suitability for the role."
}

Views

AIAssistantViewSet

This viewset includes actions for parsing resumes and matching job descriptions.

Resume Parser

@action(detail=False, methods=["post"], name="Resume Parser", url_path="resume-parser")
def resume_parser(self, request, pk=None):
    ...

Job Matcher

@action(detail=False, methods=["post"], name="Matches Candidate with a Job Description", url_path="job-matcher")
def job_matcher(self, request, pk=None):
    ...

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.

License

This project is licensed under the MIT License.