JobsHunt.ai

Local-first job search automation with FastAPI, React, and LLMs. Resume tailoring and structured evaluation stay on your machine.

Python · FastAPI · React · LLMs · Automation

Live site →GitHub →

Overview

JobsHunt.ai is a local-first job search assistant. FastAPI, React, and an on-device LLM path tailor resumes and evaluate postings without a hosted backend.

JobsHunt local evaluation flowJob intakeboards · pasteLocal APIFastAPILLM draftresume fitPrivate storelocal only
Job intake stays local: FastAPI, React, and LLM-assisted evaluation without a hosted backend.

Key Features

Private Resume Tailoring

  • Local Processing: All resume processing happens on your machine—no data sent to third-party servers
  • Context-Aware Customization: Automatically adapts your resume to match specific job descriptions
  • ATS Optimization: Ensures your resume passes Applicant Tracking Systems with proper keyword optimization
  • Version Management: Track and manage multiple versions of your resume for different roles

Intelligent Job Evaluation

  • Structured Analysis: Automatically extracts and analyzes key information from job postings
  • Fit Scoring: Evaluates how well your profile matches the job requirements
  • Missing Skills Detection: Identifies gaps in your skillset for targeted learning
  • Company Research: Aggregates relevant company information to prepare for applications

LLM-Powered Assistance

  • Natural Language Interaction: Conversational interface for drafting cover letters and responses
  • Smart Suggestions: Context-aware recommendations for improving application materials
  • Interview Prep: Generate potential interview questions based on job descriptions
  • Communication Drafting: Help with follow-up emails and thank-you notes

Technical Architecture

Backend (FastAPI)

  • REST API: Clean, well-documented API endpoints for all job search operations
  • LLM Integration: Modular design supporting multiple LLM providers (OpenAI, Anthropic, local models)
  • Document Processing: Parse and analyze resumes and job descriptions in multiple formats
  • Data Storage: SQLite for local job tracking and version history

Frontend (React)

  • Modern UI: Clean, responsive interface built with React and Tailwind CSS
  • Real-Time Updates: WebSocket connections for live LLM streaming responses
  • Dashboard: Track application status, interviews, and follow-ups in one place
  • Export Options: Generate PDFs and formatted documents for submission

Privacy & Security

  • Local-First Architecture: All sensitive data stays on your machine
  • No Cloud Dependencies: Optional LLM API usage—can run with local models
  • Data Ownership: Full control over your job search data and history
  • Encrypted Storage: Optional encryption for sensitive information

Use Cases

  1. Resume Optimization: Quickly adapt your resume for specific job applications
  2. Application Tracking: Manage multiple applications and their status
  3. Research Automation: Gather company and role information efficiently
  4. Cover Letter Generation: Draft tailored cover letters with AI assistance
  5. Interview Preparation: Generate practice questions and talking points

Installation & Setup

# Clone the repository
git clone https://github.com/ramakrishnanayyappan/jobshunt.git
cd jobshunt

# Install backend dependencies
pip install -r requirements.txt

# Install frontend dependencies
cd frontend
npm install

# Configure LLM provider (optional)
cp .env.example .env
# Edit .env with your API keys or local model configuration

# Start the backend
python main.py

# Start the frontend (in another terminal)
cd frontend
npm start

Configuration

JobsHunt supports multiple LLM providers:

  • OpenAI: GPT-4, GPT-3.5-turbo
  • Anthropic: Claude models
  • Local Models: Ollama, llama.cpp, or any OpenAI-compatible API

Releases

  • v1.1.0 (Latest): Enhanced ATS optimization, improved document parsing, new interview prep features
  • v1.0.0: Initial release with core resume tailoring and job tracking functionality

Future Enhancements

  • Browser Extension: Capture job postings directly from job boards
  • LinkedIn Integration: Import profile data and export optimized profiles
  • Analytics Dashboard: Insights on application success rates and patterns
  • Collaborative Features: Share templates and strategies (while keeping data private)
  • Mobile App: Companion app for on-the-go application management

Contributing

Contributions are welcome! This project benefits from:

  • Bug reports and feature requests
  • Code contributions (backend, frontend, LLM integrations)
  • Documentation improvements
  • Testing and feedback

License

MIT License - see the repository for details.

Note: JobsHunt is designed for personal use to streamline your job search while maintaining privacy and control over your data.