JobsHunt

Local-first job search automation with FastAPI + React + LLMs. Private resume tailoring, ATS-optimized drafting, and structured job evaluation with no hosted backend.

June 15, 2024
PythonFastAPIReactLLMsAutomation
View on GitHub

Overview

JobsHunt is a local-first job search automation tool that puts privacy and control back in the hands of job seekers. Built with FastAPI, React, and integrated with large language models, it provides intelligent assistance for resume tailoring, job evaluation, and application optimization—all running entirely on your local machine.

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.