Skip to content

mahtabfarrokh/HuntMate

Repository files navigation

HuntMate

Logo


The idea for this repo came from my frustration with job searching—many times, I feel like I need to talk directly to LinkedIn and explain exactly what I want (and don’t want) in a job search.

Too often, I find myself overwhelmed by the amount of manual work required to find relevant job postings, filter through them, and apply. It’s time-consuming, repetitive, and, honestly, exhausting.

So, I decided to build HuntMate—an AI-powered job search assistant—to make my own job hunt easier and, hopefully, help others too!

Since a true mate should be able to handle a variety of requests, HuntMate is an LLM agent at its core, powered by GPT-4o-mini. However, you can swap out the LLM with any model of your choice.

🛠️ Development is currently in progress, and I would appreciate any sort of insights or suggestions!

Configuration Instructions

1. Set Up a Virtual Environment and Install Dependencies

python -m venv env
source env/bin/activate
pip install -r requirements.txt 

2. Config api.cfg

Update api.cfg.example with your username, password, and API keys, then rename it to api.cfg.

Run HuntMate

To launch the app, run the following command in your terminal:

streamlit run app.py

The application defaults to using gpt-4o-mini as its language model. However, you can select a different LLM since the application utilizes LiteLLM for model integration. Note that the application requires a model with structured-output capabilities. To specify a different model, use:

streamlit run app.py -- --model_name="gpt-4o"

About

Your companion for job hunting! :)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages