Skip to content

Repository files navigation

CoverMail logo

CoverMail

CoverMail is a local AI job application generator that turns a job posting plus a profile file into:

  • a tailored outreach email
  • a tailored PDF cover letter

It runs locally with Ollama and can either scrape a Seek job listing or accept a pasted job description manually.

Requirements

  • Python 3.10+
  • Ollama installed locally
  • An Ollama model available locally, currently llama3.1:8b

Setup

Create and activate a virtual environment:

python3 -m venv .venv
source .venv/bin/activate

Install Python dependencies:

pip install -r requirements.txt

Pull the model used by the script:

ollama pull llama3.1:8b

Configuration

Create your private profile file from the sample and keep it local:

cp about_me.txt.sample about_me.txt

Edit the globals at the top of main.py to match the applicant identity you want to generate for:

MODEL_NAME = "llama3.1:8b"
ABOUT_ME_PATH = Path("about_me.txt")
APPLICANT_NAME = "John Appleseed"
PDF_FILENAME_SUFFIX = "Appleseed"

Profile File Format

The script expects about_me.txt to contain your raw profile context in plain text. It does not need strict JSON or YAML formatting. A practical format is:

John Appleseed
Marketing Manager

Short profile summary

Professional Experience
- Company — Role — Dates
  - achievement
  - achievement

Education
- Degree — Institution

Skills
- skill
- skill

The generator works best when the file is specific, factual, and written in bullet-heavy resume style.

Usage

Run the app:

python3 main.py

About

AI for tailored cover letter PDF generation and emails for job applications. Uses your personal details locally for accurate and humanized drafts.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages