Job-Helper-Agent

Simple AI agent for job hunting

What It Does

An AI-powered career assistant that helps users match their CV/resume against job postings. It can read CV files, fetch job listings, and provide tailored advice on job suitability.

• Read and analyze CV/resume files (PDF, DOCX, DOC)
• Fetch and summarize job postings from URLs
• Compare CV against job requirements
• Suggest CV improvements for target roles

Set up

python -m pip install -r requirements.txt

Example

Workflow:

                      ┌─────────────────────────────────────────┐
                      │                 START                   │                                                                                                                                                                                                                                                                                                                             
                      └─────────────────┬───────────────────────┘                                                                                                                                                                                                                                                                                                                             
                                        │                                                                                                                                                                                                                                                                                                                                                     
                                        ▼                                                                                                                                                                                                                                                                                                                                                     
                      ┌─────────────────────────────────────────┐                                                                                                                                                                                                                                                                                                                             
                      │              assistant                  │                                                                                                                                                                                                                                                                                                                             
                      │  ┌───────────────────────────────────┐  │                                                                                                                                                                                                                                                                                                                             
                      │  │  - Receives MessagesState         │  │                                                                                                                                                                                                                                                                                                                             
                      │  │  - Prepends system prompt         │  │                                                                                                                                                                                                                                                                                                                             
                      │  │  - Calls GPT-4.1 with tools       │  │                                                                                                                                                                                                                                                                                                                             
                      │  │  - Returns AIMessage              │  │                                                                                                                                                                                                                                                                                                                             
                      │  └───────────────────────────────────┘  │                                                                                                                                                                                                                                                                                                                             
                      └─────────────────┬───────────────────────┘                                                                                                                                                                                                                                                                                                                             
                                        │                                                                                                                                                                                                                                                                                                                                                     
                                        ▼                                                                                                                                                                                                                                                                                                                                                     
                      ┌─────────────────────────────────────────┐                                                                                                                                                                                                                                                                                                                             
                      │           tools_condition               │                                                                                                                                                                                                                                                                                                                             
                      │         (conditional edge)              │                                                                                                                                                                                                                                                                                                                             
                      └───────┬─────────────────────┬───────────┘                                                                                                                                                                                                                                                                                                                             
                              │                     │                                                                                                                                                                                                                                                                                                                                         
                     has tool_calls           no tool_calls                                                                                                                                                                                                                                                                                                                                   
                              │                     │                                                                                                                                                                                                                                                                                                                                         
                              ▼                     ▼                                                                                                                                                                                                                                                                                                                                         
          ┌───────────────────────────┐   ┌─────────────────┐                                                                                                                                                                                                                                                                                                                                 
          │          tools            │   │      END        │                                                                                                                                                                                                                                                                                                                                 
          │  ┌─────────────────────┐  │   └─────────────────┘                                                                                                                                                                                                                                                                                                                                 
          │  │ • extract_cv_text   │  │                                                                                                                                                                                                                                                                                                                                                       
          │  │ • search_job_posting│  │                                                                                                                                                                                                                                                                                                                                                       
          │  └─────────────────────┘  │                                                                                                                                                                                                                                                                                                                                                       
          └─────────────┬─────────────┘                                                                                                                                                                                                                                                                                                                                                       
                        │                                                                                                                                                                                                                                                                                                                                                                     
                        │ (always returns to assistant)                                                                                                                                                                                                                                                                                                                                       
                        │                                                                                                                                                                                                                                                                                                                                                                     
                        └────────────────────────────────────────┐                                                                                                                                                                                                                                                                                                                            
                                                                 │                                                                                                                                                                                                                                                                                                                            
                      ┌──────────────────────────────────────────┘                                                                                                                                                                                                                                                                                                                            
                      │                                                                                                                                                                                                                                                                                                                                                                       
                      ▼                                                                                                                                                                                                                                                                                                                                                                       
                (back to assistant)