Jobber/README.md

JobOps

AI-powered job discovery and application pipeline. Automatically finds jobs, scores them against your profile, and generates tailored resumes.

Workflow

1. Search: Scrapes Gradcracker, Indeed, LinkedIn, and UK Visa Sponsorship jobs.
2. Score: AI ranks jobs by suitability using OpenRouter.
3. Tailor: Generates a custom resume summary for top-tier matches.
4. Export: Automates RxResume to create tailored PDFs.
5. Manage: Review and mark jobs as "Applied" via the dashboard (syncs to Notion).

Example of generating a tailored resume for a job

https://github.com/user-attachments/assets/5b9157a9-13b0-4ec6-9bd2-a39dbc2b11c5

Example of applying to a Ready job

https://github.com/user-attachments/assets/06e5e782-47f5-42d0-8b28-b89102d7ea1b

Quick Start

# 1. Clone and move to directory
git clone https://github.com/DaKheera47/job-ops.git
cd job-ops

# 2. Docker up (this will take a while because of Camoufox)
docker compose up -d --build

# 3. Open the dashboard, the app will onboard your credentials
# http://localhost:3005

The app will guide you through setup on first launch. The onboarding wizard helps you:

• Connect your OpenRouter API key (for AI scoring/tailoring)
• Add your RxResume credentials (for PDF export)
• Upload your base resume JSON (exported from RxResume)

Structure

• /orchestrator: React frontend + Node.js backend & pipeline.
• /extractors: Specialized scrapers (Gradcracker, JobSpy, UKVisaJobs).
• /resume-generator: Python script for RxResume PDF automation.
• /data: Persistent storage for SQLite DB and generated PDFs.

Technical breakdowns here: documentation/extractors/README.md Orchestrator docs here: documentation/orchestrator.md

Read-only mode (Basic Auth)

You can make the app read-only for the public by setting a username and password in the Settings page. After this, all write actions (POST/PATCH/DELETE) require Basic Auth; browsing and viewing remain public.

Persistent data lives in ./data (bind-mounted into the container).

Running (local dev)

Prereqs: Node 20+, Python 3.10+, Playwright browsers (Firefox).

Install Node deps (both packages):

cd orchestrator && npm install
cd ../extractors/gradcracker && npm install

Configure the orchestrator env + DB:

cd ../orchestrator
cp .env.example .env
npm run db:migrate
npm run dev

Set up the resume generator (used for PDF export):

cd ../resume-generator
python -m venv .venv
# Windows PowerShell:
.\.venv\Scripts\Activate.ps1
# macOS/Linux:
# source .venv/bin/activate
pip install playwright
python -m playwright install firefox

Dev URLs:

• API: http://localhost:3001/api
• UI (Vite): http://localhost:5173

Notes / sharp edges

• Crawl targets: edit extractors/gradcracker/src/main.ts to change the Gradcracker location/role matrix.
• Pipeline config knobs: POST /api/pipeline/run accepts { topN, minSuitabilityScore }; PIPELINE_TOP_N/PIPELINE_MIN_SCORE are used by npm run pipeline:run (CLI runner).
• Anti-bot reality: crawling is headless + "humanized", but sites can still block; expect occasional flakiness.

Note on Analytics: The current alpha version includes anonymous analytics (Umami) to help me debug performance. This will be made opt-in only in the upcoming updates. If you want to disable it now, block umami.dakheera47.com in your firewall.

License

AGPLv3