job-hunting-ai / README.md
mananshah296's picture
Update README.md
10545a8 verified

A newer version of the Gradio SDK is available: 5.44.1

Upgrade
metadata
title: Career Compass AI
emoji: 🧭
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 5.33.0
app_file: app.py
pinned: false
license: mit
tags:
  - agent-demo-track

Career Compass AI 🧭

An AI-powered career assistant that combines intelligent job searching, resume matching, and cover letter generation using an agent-based architecture.

Demo Link πŸ“Ή

[https://youtu.be/7jiuIUsO28k]

🌟 Key Features

1. πŸ” Smart Job Search

  • AI-enhanced job discovery using LangChain agents
  • SerpAPI integration for comprehensive job data
  • Intelligent filtering for location and remote work
  • Salary information parsing when available
  • Experience level filtering
  • Support for multiple locations including US, Canada, UK, and more
  • Fast and Advanced search modes

2. πŸ“Š Resume Analysis & Matching

  • PDF resume parsing and analysis
  • AI-powered job description matching
  • Detailed skills gap analysis
  • Match score calculation
  • Confidence metrics
  • Improvement suggestions

3. ✍️ Cover Letter Generation

  • Context-aware content generation
  • Personalized based on resume and job
  • Professional formatting
  • Customizable output

πŸ€– Agent Architecture

Job Search Agent

  • Uses LangChain for orchestration
  • Custom MRKL output parser
  • Intelligent retry mechanisms
  • Contextual job filtering

Resume Analysis Agent

  • Resume parsing capabilities
  • Skills extraction
  • Match calculation
  • Improvement suggestions

🎨 Custom UI Components

  • Modern, responsive design
  • Dark mode support
  • Interactive job listings table
  • Analysis dashboards
  • Status indicators
  • Export functionality (CSV/JSON)

πŸ”‘ Required API Keys

  1. SerpAPI Key (Required for all searches)

    • Get from SerpAPI
    • Used for job searching
  2. Nebius API Key (Required for Advanced Search)

    • Get from Nebius
    • Powers AI-enhanced features

πŸ“ How to Use

  1. Configure API Keys
  2. Choose search method:
    • Advanced Search (AI-Enhanced, 30-60s)
    • Basic Search (Fast, 10-30s)
  3. Enter job search criteria:
    • Job title/keywords
    • Location
    • Experience level
    • Remote work preference
  4. View results and export if needed
  5. For resume matching:
    • Upload PDF resume
    • Paste job description
    • Get detailed analysis
    • Generate custom cover letter

πŸ”’ Security

  • API keys stored in memory only
  • No permanent data storage
  • Secure data handling
  • Session-based isolation

πŸ“Š Session Information

  • Current Time: 2025-06-10 18:47:07 UTC
  • Current User: mananshah296
  • Version: 2.0.0
  • Last Updated: 2025-06-10

πŸ—οΈ High-Level Architecture Diagram

image/png

πŸ“œ License

MIT License

Copyright (c) 2025 mananshah296

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.