opaux 0.1.0

Automated job application pipeline powered by Claude AI

Opaux — Automated Job Application CLI

Opaux is a modular Python CLI tool that automates the end-to-end job application process: discovering jobs, scoring them with AI, tailoring your CV, generating cover letters, and submitting applications.

Features

• Discovery — Scrapes LinkedIn, Indeed, Glassdoor and more via python-jobspy
• AI Scoring — Uses Claude to score each job against your profile (1–10)
• CV Tailoring — Generates tailored .docx CVs in American, German, or Europass format
• Cover Letters — AI-generated, personalized cover letters
• Auto Apply — Playwright-powered form filler for online applications
• Tracker — Rich terminal dashboard with analytics

Installation

pip install -e .
playwright install chromium

Configuration

1. Copy and edit config/profile.yaml with your personal details
2. Copy and edit config/settings.yaml — add your Claude API key and search parameters

Usage

# Discover new jobs
opaux discover

# Score unscored jobs (AI-powered)
opaux score --limit 50 --min-score 6.0

# Tailor your CV for a specific job
opaux tailor JOB_ID --format american
opaux tailor JOB_ID --format german --lang de
opaux tailor JOB_ID --format europass --lang fr

# Generate a cover letter
opaux cover JOB_ID

# Apply to a job (dry run first!)
opaux apply JOB_ID --dry-run
opaux apply JOB_ID

# Track applications
opaux track
opaux track --status applied
opaux track --export applications.csv

# Run the full pipeline
opaux pipeline --limit 10 --min-score 7.0

Project Structure

opaux/
├── main.py                    # Click CLI entry point
├── requirements.txt
├── setup.py
├── config/
│   ├── profile.yaml           # Your personal profile
│   └── settings.yaml          # API keys, search params
├── templates/
│   ├── cv_american.yaml
│   ├── cv_german.yaml
│   └── cv_europass.yaml
├── src/
│   ├── database.py
│   ├── discovery.py
│   ├── scoring.py
│   ├── tailoring.py
│   ├── cv_formats.py
│   ├── translator.py
│   ├── docx_builder.py
│   ├── cover_letter.py
│   ├── applicator.py
│   └── tracker.py
├── data/                      # SQLite DB (auto-created)
├── output/                    # Generated CVs and cover letters
└── tests/

Supported CV Formats

Format	Features
American	Clean single-column, no personal data, ATS-optimized
German	Photo placeholder, DOB/nationality, signature block
Europass	CEFR language grid, DIGCOMP digital competence grid, EQF labels

Supported Languages for Translation

de fr es pt nl it pl sv da no fi cs hu ro bg el tr ar zh ja ko #\x00 \x00O\x00p\x00a\x00u\x00x\x00 \x00 \x00