QuickApply

English | 简体中文

🚀 QuickApply turns local resumes, market-specific search profiles, and JobSpy scraping into one focused application operations desk.

JobSpy-powered · Built with Codex · UI inspired by sub2api

QuickApply is built for people who do not want a generic job board dashboard. It is for targeted application work:

• bring in one or more LaTeX resumes
• define market-aware search profiles
• scrape locally with JobSpy
• review, exclude, and track jobs in one place
• push structured tailoring instructions into the same Codex workflow

✨ Why It Feels Different

• Resume-driven instead of keyword chaos: profiles and resumes stay close to the actual roles you want.
• Local-first instead of SaaS lock-in: data, workspaces, and generated PDFs live on your machine.
• Operations-oriented instead of list-oriented: Dashboard, Crawler, Jobs, Tracker, and Tailor form one loop.
• Dedicated job-page window instead of tab sprawl: QuickApply reuses one separate Chrome window for job pages, refreshing that window instead of spraying new tabs everywhere.
• Safe to share publicly: this public repo ships with a fully synthetic demo persona, Taylor Brooks.

🧭 The Workflow

1. Import one or more resumes.
2. Create search profiles that match a real market.
3. Run JobSpy-powered crawls locally.
4. Filter the pool down to roles worth attention.
5. Track applications and tailor a resume for the next serious role.

🖼️ Product Tour

The screenshots below mirror the real workflow documented in docs/workflows.md.

Dashboard See high matches, recent crawls, tracker activity, and tailoring status.	Crawler Manage profiles, keywords, locations, sources, and crawl history.
Jobs Filter aggressively, reuse one dedicated Chrome window for job pages, exclude noise, and launch Tailor.	Tracker Keep applied jobs, manual entries, stages, and notes in one timeline.

⚡ Quick Start

Local

uv sync --dev
uv run python scripts/seed_demo_data.py --replace
uv run python main.py

Open http://127.0.0.1:5273/dashboard.

Docker

docker compose up -d --build
docker compose run --rm quickapply uv run python scripts/seed_demo_data.py --replace

Open http://127.0.0.1:5273/dashboard.

📚 Documentation

Start here:

• Documentation Home
• Quick Start Guide
• Configuration Guide
• Workflow Tour
• Tailor Workflow
• Deployment and Operations

Chinese docs:

• 文档首页
• 快速开始
• 配置说明
• 抓取与投递流程
• Tailor 精修说明
• 部署与运维

🔒 Public Demo Notes

• The example resumes, projects, and references are synthetic.
• The public repo is intentionally positioned around a B2B SaaS commercial persona.
• The screenshots are generated from seeded demo data, not real user records.

🗂️ Repository Layout

app/             Flask app, JobSpy fetch flow, scoring, storage, Tailor service
config/          Search profiles and runtime config
data/            SQLite DB and generated workspaces
docs/            Public docs and screenshots
examples/        Synthetic resumes, project library, reference library, templates
scripts/         Startup helpers and demo seeding
static/          CSS, i18n assets, and public-facing static files
templates/       Jinja templates
tests/           Route, config, scoring, and Tailor tests
.codex/skills/   Public Tailor skills

🧪 Tests

PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 uv run python -m pytest -q