AutoApply

AutoApply is a local-first job application automation workspace. It helps a job seeker discover roles, score fit, generate tailored application materials, prepare applications, and track outcomes while keeping every submit behind an explicit human decision.

The product combines a Vue/FastAPI operator console, PostgreSQL-backed job and application records, Redis/Celery background work, auditable agent traces, and a provider-agnostic LLM layer supporting OpenAI, Anthropic, Gemini, DeepSeek, Moonshot/Kimi, Qwen, xAI Grok, Groq, Mistral, OpenRouter, Ollama (local), the Claude and Codex CLIs, and user-defined custom OpenAI-compatible providers.

License: PolyForm Noncommercial 1.0.0. Personal, academic, and nonprofit use is free. Commercial use requires a separate license; see Commercial Use.

Product

AutoApply is designed for users who want automation without losing control over sensitive application actions.

• Job discovery: Search LinkedIn-discovered roles and supported ATS platforms, normalize postings, and keep a durable Job Index.
• Fit scoring: Combine hard rules, semantic matching, freshness checks, and explainability for rejected or borderline jobs.
• Applicant memory: Maintain structured profile data, story bank entries, bullet pools, and reusable Q&A material.
• Materials workspace: Generate resumes and cover letters from a job or pasted JD, using templates, source documents, and evidence-grounded IR.
• Document library: Curate trusted resumes and cover letters, reuse them as generation bases, and promote generated artifacts when they are worth keeping.
• Automation plans: Create user-defined recurring tasks that search, scrape, score, prepare materials, and optionally auto-apply eligible jobs.
• Review and submission: Review prepared applications, replace materials, approve submissions, and keep submit actions gated.
• Tracking and analytics: Track application status, generated artifacts, outcomes, task history, and provider/agent cost telemetry.

Current Status

Core product development is complete through Phase 18: Worker Activation, Reliability, Parallelism, and automatic artifact Cleanup with quarantine/audit (layered on top of Phase 17.9: LLM Provider Expansion).

The current application includes the Job Index, task queue with closed-out worker bodies (no fake "scheduled" / "stubbed" success returns), async materials generation that returns task_id + structured TaskRecord.result, a dead_lettered state + "Stuck / failed" tab for retries/discards, an automatic artifact-cleanup pipeline with quarantine + restore + purge, atomic-write protection on every materials writer, process-wide LLM rate-limit gates (global + per-provider), and the existing Phase 17.x surface (review queue, document library, material strategy defaults, multi-vendor provider management with per-provider model catalogs, Settings model picker, custom OpenAI-compatible providers, optional cheap-model tier, LinkedIn session management, modern Vue web console). Browser form-fill / click-submit, saved-search registry fanout, and outcome status sync are still explicit not_implemented paths rather than silent fake successes; legacy submit entrypoints now keep entries approved/queued instead of marking them submitted. The roadmap from here is Phase 19 (Per-Posting Tag Cache & Filter Fast Path plus saved-search registry fanout) → Phase 20 (Custom Job Sources / Connectors with URL safety, bounded multi-source search, and feature-gated template DSL) → Phase 21 (Multi-tenancy & Auth Hardening) → future ATS-first application status sync.

Latest local verification in this workspace:

• uv run pytest -q: 1720 passed, 1 skipped (2026-05-21, after Phase 18)
• npm run build: passed, with the existing Vite chunk-size warning
• Alembic head: b8d2f9e15c33 (Phase 18.3 DLQ columns); the Phase 18 schema chain is e7c3a5b91f48 → f4e8c1d2a907 → a1c7b3e54f08 → b8d2f9e15c33

For implementation-level history, see Phase History and Changelog.

Quick Start

Install dependencies once, then use the unified local launcher:

# 1. Set AUTOAPPLY_DB_PASSWORD in .env (any non-empty value), then install deps
uv sync
uv run playwright install chromium
uv run autoapply init

# 2. Start Postgres + Redis, migrations, Celery worker/Beat, and the web UI
uv run autoapply start

Open the web console at http://127.0.0.1:8000.

autoapply start runs Docker Compose for data dependencies (Postgres + Redis), applies Alembic migrations, starts Celery worker and Beat, then launches the Python web app on the host. Use uv run autoapply start --check to print the exact startup plan without starting anything. If the default host ports are unavailable, the launcher chooses alternate ports and passes them to Compose, Alembic, Celery, and the web process for that run. It is cross-platform; Docker Desktop can be auto-launched on Windows/macOS when installed, while Linux expects the Docker daemon to already be available. For a single-server production install that runs the same processes under one supervisor, see supervisord.conf and section 15 of the deployment guide.

If you modify frontend files:

cd frontend
npm install
npm run build

The repository includes built SPA assets under src/web/static/spa, so a frontend rebuild is only required after editing frontend/.

Requirements

Common Commands

# Database schema
uv run alembic upgrade head

# All-in-one local runtime
uv run autoapply start

# Web console only
uv run autoapply web --host 127.0.0.1 --port 8000

# Provider setup
uv run autoapply provider list
uv run autoapply provider set-key openai sk-...
uv run autoapply provider set-primary openai
uv run autoapply provider test openai

# Search and tracking
uv run autoapply search --source linkedin --keyword "software engineer" --location "Canada" --max-pages 3
uv run autoapply status

# Background workers
uv run autoapply worker --queues search,materials,application,maintenance
uv run autoapply beat

# Automation plan runs
uv run autoapply plan-runs run --profile default --top-n 10
uv run autoapply pause-plan-runs --clear-pending
uv run autoapply resume-plan-runs

Use the deployment guides for complete setup and production notes.

Architecture

Documentation

Project Layout

frontend/             Vue SPA source
migrations/           Alembic schema migrations
src/application/      CLI/Web use cases
src/agent/            Agent harness, tools, traces, evals
src/cli/              autoapply command groups
src/core/             Models, configuration, database wiring
src/documents/        Template eng