Skip to content

seanivore/ai-job-hunter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AI Job Hunter

Your intelligent job search agent that finds perfect opportunities and crafts compelling applications.

What It Does

AI Job Hunter automates your job search by:

  • Finding fresh job postings across major ATS platforms
  • Matching opportunities to your experience
  • Generating tailored cover letters with concrete examples
  • Creating clean, professional PDFs
  • Delivering complete application packages via email

Key Features

Smart Job Search

  • Searches ATS platforms directly (Lever, Greenhouse, etc.)
  • Finds positions before they hit major job boards
  • Filters by your preferences and requirements

Intelligent Matching

  • Uses RAG system to understand your experience
  • Matches job requirements to your skills
  • Ranks opportunities by fit

Professional Documents

  • Generates tailored cover letters
  • Creates clean PDFs with VS Code styling
  • Maintains consistent formatting

Easy Delivery

  • Sends application packages via email
  • Includes all necessary attachments
  • Tracks application status

Quick Start

# Install
npm install -g ai-job-hunter

# Set up your profile
hunt init

# Configure preferences
hunt config

# Start searching
hunt start

Configuration

Create a .env file:

# Required APIs
OPENAI_API_KEY=your_key    # For understanding jobs
BING_API_KEY=your_key      # For job search
CLAUDE_API_KEY=your_key    # For document generation

# Email (choose one)
GMAIL_TOKEN=your_token     # For Gmail
# or
SMTP_CONFIG=your_config    # For other email

Usage Examples

  1. Start a job search:
# Search with default preferences
hunt search

# Search with specific criteria
hunt search --role "frontend" --remote --salary "100k+"
  1. Review matches:
# See all matches
hunt matches list

# View specific match
hunt matches view "company-name"
  1. Generate materials:
# Create cover letter
hunt generate letter "company-name"

# Create full package
hunt generate package "company-name"

Requirements

  • Node.js 18+
  • Email account (Gmail recommended)
  • Required API keys (see Configuration)

Support

License

MIT