How iamkach/careerpilot-ai works
Careerpilot AI is a deterministic job-search pipeline: it gathers and scores listings, lets the user review them in Notion, then produces tailored application materials and follow-up guidance. Its optional apply workflow plans answers and can prefill a live form without submitting it. The graph preserves the documented stages and the substantial apply subsystem; some extension-to-server wiring is not shown in the excerpts, so that relationship is marked unverified.
Main entry points: run.py Stage Runner · utils.py Notion Tracker · stage2_tailor.py Resume Tailoring · stage6_negotiate.py Offer Negotiation
Components 25
Pipeline Control
- Stage Runner
run.py
Job Discovery
- Job Sources
scripts/sources.py - Scrape & Score
scripts/stage1_scrape.py - Human Review
Career Workflow
- Resume Tailoring
scripts/stage2_tailor.py - DOCX Editing
scripts/render_docx.py - Outreach Drafts
scripts/stage3_outreach.py - Job Digest
scripts/stage4_digest.py - Interview Prep
scripts/stage5_interview_prep.py - Offer Negotiation
scripts/stage6_negotiate.py
Application Assist
- Application Planner
scripts/autoapply.py - Apply Profile
scripts/autoapply_profile.py - Browser Prefill
scripts/autoapply_browser.py - Local HTTP Bridge
scripts/autoapply_server.py - Browser Extension
extension/content.js
Shared Services
- Profile & Settings
config/settings.py - Notion Tracker
scripts/utils.py - AI Dispatcher
scripts/utils.py - Notion Provisioning
scripts/provision_notion.py
Other components
- Job Seeker
- Job Boards
- AI Providers
- Gmail
- Base Resume
config/resume.example.txt - Generated Files
Connections 45
- Job Seeker → Stage Runner: runs stages
README.md - Profile & Settings → Stage Runner: configures
README.md - Stage Runner → Scrape & Score: dispatches
run.py - Stage Runner → Resume Tailoring: dispatches
run.py - Stage Runner → Outreach Drafts: dispatches
run.py - Stage Runner → Job Digest: dispatches
run.py - Stage Runner → Interview Prep: dispatches
run.py - Stage Runner → Offer Negotiation: dispatches
run.py - Stage Runner → Application Planner: dispatches
run.py - Stage Runner → Notion Provisioning: initializes
run.py - Scrape & Score → Job Sources: fetches listings
scripts/stage1_scrape.py - Job Sources → Job Boards: queries
scripts/sources.py - Scrape & Score → AI Dispatcher: scores jobs
README.md - AI Dispatcher → AI Providers: dispatches calls
scripts/utils.py - Scrape & Score → Notion Tracker: records jobs
README.md - Job Seeker → Human Review: reviews listings
README.md - Human Review → Notion Tracker: updates status
README.md - Resume Tailoring → Notion Tracker: reads reviewed jobs
README.md - Resume Tailoring → AI Dispatcher: requests edits
scripts/stage2_tailor.py - Resume Tailoring → DOCX Editing: applies edits
scripts/stage2_tailor.py - Resume Tailoring → Base Resume: uses template
README.md - Resume Tailoring → Generated Files: writes resumes
README.md - Resume Tailoring → Notion Tracker: updates status
README.md - Outreach Drafts → AI Dispatcher: drafts messages
README.md - Outreach Drafts → Generated Files: writes drafts
README.md - Outreach Drafts → Notion Tracker: records confirmed send
README.md - Job Digest → Notion Tracker: collects jobs
README.md - Job Digest → Generated Files: writes digest
README.md - Job Digest → Gmail: sends optionally
README.md - Interview Prep → AI Dispatcher: generates guide
README.md - Interview Prep → Generated Files: writes guide
README.md - Interview Prep → Notion Tracker: updates status
README.md - Offer Negotiation → Notion Tracker: looks up offer
scripts/stage6_negotiate.py - Offer Negotiation → AI Dispatcher: generates brief
README.md - Offer Negotiation → Generated Files: writes brief
README.md - Offer Negotiation → Notion Tracker: updates status
scripts/stage6_negotiate.py - Application Planner → Notion Tracker: reads ready jobs
scripts/autoapply.py - Application Planner → Apply Profile: uses profile
- Application Planner → Browser Prefill: hands off plan
scripts/autoapply.py - Browser Prefill → Generated Files: captures form
scripts/autoapply_browser.py - Local HTTP Bridge → Application Planner: builds plans
scripts/autoapply_server.py - Local HTTP Bridge → Browser Prefill: invokes prefill
scripts/autoapply_server.py - Browser Extension → Local HTTP Bridge: exchanges form data
- Job Seeker → Browser Extension: uses extension
- Notion Provisioning → Notion Tracker: creates workspace
scripts/provision_notion.py