Skip to content

adeeljames/ReAct-Job-Agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ReAct Job Agent

An AI-powered job assistant that fetches remote job listings and generates personalized, human-like cover letters using LLMs via the Groq API.

Features

  • Fetches remote jobs from the Remotive API
  • Generates tailored cover letters (200-250 words) using llama-3.3-70b-versatile
  • Interactive Streamlit UI for searching jobs and generating/downloading cover letters
  • Clean HTML parsing for readable job descriptions

Project Structure

.
├── agent.py          # Core agent logic: fetch jobs, generate cover letters
├── ui.py             # Streamlit web interface
├── .env              # API keys (not committed)
├── .env.example      # Example environment file
└── .venv/            # Python virtual environment

Setup

  1. Clone the repository
  2. Create a virtual environment and install dependencies:
    python -m venv .venv
    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
    pip install groq python-dotenv requests streamlit
  3. Copy .env.example to .env and add your Groq API key:
    cp .env.example .env
  4. Run the Streamlit app:
    streamlit run ui.py

Usage

CLI Mode

Run the agent directly to generate cover letters from the terminal:

python agent.py

Web UI

Launch the interactive Streamlit interface:

streamlit run ui.py

Requirements

  • Python 3.8+
  • Groq API key (Get one here)
  • Internet connection for job fetching

Made with love by @muhammadadeelai

About

An AI-powered job assistant that fetches remote job listings and generates personalized, human-like cover letters using LLMs via the Groq API.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages