https://github.com/seanivore/ai-job-hunter
AI Job Hunting Agent
https://github.com/seanivore/ai-job-hunter
agent anthropic-api automation bing-api convert-markdown-to-pdf cover-letter cover-letter-generator gmail-smtp job-search markdown-renderer markdown-to-pdf openai-api pdf vscode-markdown
Last synced: 3 months ago
JSON representation
AI Job Hunting Agent
- Host: GitHub
- URL: https://github.com/seanivore/ai-job-hunter
- Owner: seanivore
- Created: 2025-02-07T10:14:16.000Z (4 months ago)
- Default Branch: ai-job-hunter
- Last Pushed: 2025-03-19T09:18:05.000Z (3 months ago)
- Last Synced: 2025-03-19T10:26:52.530Z (3 months ago)
- Topics: agent, anthropic-api, automation, bing-api, convert-markdown-to-pdf, cover-letter, cover-letter-generator, gmail-smtp, job-search, markdown-renderer, markdown-to-pdf, openai-api, pdf, vscode-markdown
- Homepage: https://seanivore.github.io/portfolio/
- Size: 3.91 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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
```bash
# 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:
```env
# Required APIs
OPENAI_API_KEY=your_key # For understanding jobs
BING_API_KEY=your_key # For job search
ANTHROPIC_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:
```bash
# Search with default preferences
hunt search
# Search with specific criteria
hunt search --role "frontend" --remote --salary "100k+"
```
2. Review matches:
```bash
# See all matches
hunt matches list
# View specific match
hunt matches view "company-name"
```
3. Generate materials:
```bash
# 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
- [OpenAI API Key](https://platform.openai.com/settings/organization/api-keys)
- [GitHub Issues](https://github.com/yourusername/ai-job-hunter/issues)
- [Discussions](https://github.com/yourusername/ai-job-hunter/discussions)
## License
MIT