Job Ops 🚀

Automated job discovery, scoring, and resume generation pipeline.

Features

Job Crawler - Discovers jobs from Gradcracker and other sources
AI Scoring - Ranks jobs by suitability using OpenRouter API
Resume Generator - Creates tailored PDFs via RXResume automation
Dashboard UI - React-based interface for reviewing and applying

Quick Start with Docker

1. Configure Environment

# Copy the example env file
cp .env.example .env

# Edit with your credentials
nano .env

Required environment variables:

OPENROUTER_API_KEY - Get from openrouter.ai/keys
RXRESUME_EMAIL - Your rxresu.me account email
RXRESUME_PASSWORD - Your RXResume password

2. Add Your Base Resume

Place your resume JSON at resume-generator/base.json. You can export this from RXResume.

3. Run

# Build and start
docker compose up -d

# View logs
docker compose logs -f

# Stop
docker compose down

4. Access

Dashboard: http://localhost:3001
API: http://localhost:3001/api
Health: http://localhost:3001/health

Data Persistence

All data is stored in the ./data directory:

data/jobs.db - SQLite database
data/pdfs/ - Generated resume PDFs

Development

Without Docker

# Install dependencies
cd orchestrator && npm install
cd ../job-extractor && npm install

# Set up Python environment for resume generator
cd ../resume-generator
python3 -m venv .venv
source .venv/bin/activate
pip install playwright
playwright install chromium

# Run orchestrator (from orchestrator folder)
cd ../orchestrator
cp .env.example .env  # Configure your env
npm run db:migrate
npm run dev

Build Docker Image

docker build -t job-ops:latest .

Push to Docker Hub

docker tag job-ops:latest yourusername/job-ops:latest
docker push yourusername/job-ops:latest

API Endpoints

Method	Endpoint	Description
GET	`/api/jobs`	List all jobs
GET	`/api/jobs/:id`	Get job details
PATCH	`/api/jobs/:id`	Update job
POST	`/api/jobs/:id/process`	Generate resume for job
POST	`/api/jobs/:id/apply`	Mark as applied
POST	`/api/jobs/:id/reject`	Skip job
POST	`/api/jobs/process-discovered`	Process all discovered jobs
GET	`/api/pipeline/status`	Pipeline status
POST	`/api/pipeline/run`	Trigger pipeline
GET	`/api/pipeline/progress`	SSE progress stream
DELETE	`/api/database`	Clear all data

Architecture

job-ops/
├── orchestrator/       # Node.js backend + React frontend
│   ├── src/server/    # Express API, services, DB
│   └── src/client/    # React dashboard
├── job-extractor/      # Crawlee-based job crawler
├── resume-generator/   # Python Playwright automation
├── data/               # SQLite DB + generated PDFs
├── Dockerfile
└── docker-compose.yml

License

MIT

3.0 KiB Raw Blame History