98 lines
3.4 KiB
Markdown
98 lines
3.4 KiB
Markdown
# 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](https://v4.rxresu.me) 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
|
|
```bash
|
|
# 1. Run with Docker
|
|
docker compose up -d --build
|
|
|
|
# 2. Open the dashboard
|
|
# 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):
|
|
|
|
```bash
|
|
cd orchestrator && npm install
|
|
cd ../extractors/gradcracker && npm install
|
|
```
|
|
|
|
Configure the orchestrator env + DB:
|
|
|
|
```bash
|
|
cd ../orchestrator
|
|
cp .env.example .env
|
|
npm run db:migrate
|
|
npm run dev
|
|
```
|
|
|
|
Set up the resume generator (used for PDF export):
|
|
|
|
```bash
|
|
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.
|
|
|
|
[](https://app.repohistory.com/star-history)
|
|
|
|
## License
|
|
|
|
AGPLv3
|