git404hub

what is job-hunt-agent fr?

ecedalpolat/job-hunt-agent — explained in plain English

Analysis updated 2026-05-18

11PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

tl;dr

An AI agent that searches job postings, scores them against your CV, and writes a tailored CV and cover letter for each job you choose, with your approval before anything is submitted.

vibe map

mindmap
  root((job hunt agent))
    What it does
      Searches job postings
      Scores fit to profile
      Writes tailored CVs
    Tech stack
      Python
      LangChain deepagents
      Streamlit UI
    Use cases
      Rank job listings
      Generate cover letters
      Track applications
    Audience
      Job seekers
      Career changers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Search LinkedIn and Indeed postings and rank them by fit against your uploaded CV.

VIBE 2

Generate a tailored CV and cover letter for each job you decide to apply to.

VIBE 3

Track which jobs you have already applied to across different chat sessions.

VIBE 4

Review and approve every application before it goes out, instead of letting the agent submit automatically.

what's the stack?

PythonLangChainStreamlitLinkedInIndeed

how it stacks up fr

ecedalpolat/job-hunt-agent2arons/llm-cliabe238/claude-video-plus
Stars111111
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity3/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Needs an API key for at least one AI provider (Anthropic, OpenRouter, or OpenAI) plus your CV file to build a profile.

MIT license: use, copy, modify, and share freely, including commercially, as long as the copyright notice stays attached.

in plain english

Job Hunt Agent is an AI assistant built to help someone search for jobs and prepare tailored application materials for each one. It is built with a framework called LangChain deepagents, which gives it planning, memory, and the ability to hand off work to smaller specialist agents. The process starts by uploading your CV. The agent reads it and builds a master profile describing your background, which becomes the single source of truth it will always draw from when writing anything about you. It then searches job postings on sites like LinkedIn and Indeed using a free scraping tool, or an optional paid search API if the scraper gets blocked. Each posting is scored for how well it fits your profile. When you pick jobs to apply to, a separate sub agent writes a tailored CV and cover letter for each one, following a structured writing format meant to read well to both humans and automated screening systems. A key safety feature is that the agent never actually submits an application without your explicit yes or no approval first, shown either in the command line or in an included web interface built with Streamlit. The agent also remembers things across separate conversations, such as companies you are targeting or preferences you mentioned, so it will not suggest a job you already applied to even in a brand new chat session. To run it, you install it as a Python package or from source, then supply an API key for one AI provider such as Anthropic, OpenRouter, or OpenAI. Job searching itself needs no API key by default. Every step is logged, including estimated cost in dollars for each AI call, so you can track spending as you use it. This project is aimed at job seekers comfortable running a command line tool or a local web app, and it is released under the MIT license.

prompts (copy fr)

prompt 1
Set up job-hunt-agent with my CV and find backend developer jobs that match my profile.
prompt 2
Prepare a tailored CV and cover letter for job listing 2 and show me before submitting.
prompt 3
Remember that I only want remote roles and re-rank my current job search results.
prompt 4
Walk me through installing this and choosing between the CLI and the Streamlit web interface.

Frequently asked questions

what is job-hunt-agent fr?

An AI agent that searches job postings, scores them against your CV, and writes a tailored CV and cover letter for each job you choose, with your approval before anything is submitted.

What language is job-hunt-agent written in?

Mainly Python. The stack also includes Python, LangChain, Streamlit.

What license does job-hunt-agent use?

MIT license: use, copy, modify, and share freely, including commercially, as long as the copyright notice stays attached.

How hard is job-hunt-agent to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is job-hunt-agent for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.