How nitin3560/careeros works
CareerOS brings job discovery, candidate matching, and application management into one workflow: jobs are collected and normalized, stored, ranked against candidate profiles, and served through a web app and REST API. Resume parsing and per-job tailoring extend that workflow. The README documents the major boundaries and capabilities; source excerpts and the index support several implementation links, but unsampled route and worker wiring is not inferred beyond those references.
Main entry points: main.py REST API · models.py PostgreSQL records · job_matching.py Job matching · ingestion.py Ingestion worker
Components 26
Job collection
- Job source adapters
apps/api/app/services/job_ingestion - Public source discovery
apps/api/app/services/job_ingestion/public_sources.py - Job normalization and persistence
apps/api/app/services/job_ingestion/persist.py - Board fetching
apps/api/app/ingestion/poller/fetcher.py - Poller normalization
apps/api/app/ingestion/poller/normalization.py - Poller writes and state
apps/api/app/ingestion/poller/repository.py - Poller scheduling
apps/api/app/ingestion/poller/scheduler.py
API and persistence
- REST API
apps/api/app/main.py - Authentication
apps/api/app/services/auth.py - API schemas
apps/api/app/schemas.py - Database sessions
apps/api/app/database.py - PostgreSQL records
apps/api/app/models.py
Candidate matching
- Resume parsing
apps/api/app/services/resume_parsing.py - Job matching
apps/api/app/services/job_matching.py - AI provider client
apps/api/app/services/ai_client.py - Resume tailoring
apps/api/app/services/tailoring.py - Resume export
apps/api/app/services/resume_export.py
Web experience
- CareerOS web app
apps/web/src/app - Web API client
apps/web/src/lib/api.ts
Background processing
- Background job tracking
apps/api/app/services/background_jobs.py - Ingestion worker
apps/api/app/workers/ingestion.py - Matching worker
apps/api/app/workers/matching.py - Redis queue
Other components
- Job seeker
- Company job sources
- LLM providers
Connections 29
- Job seeker → CareerOS web app: uses
README.md - CareerOS web app → Web API client: requests data
README.md - Web API client → REST API: calls REST
README.md - REST API → Database sessions: opens sessions
apps/api/app/main.py - REST API → API schemas: uses responses
apps/api/app/main.py - Database sessions → PostgreSQL records: queries records
apps/api/app/main.py - REST API → Authentication: uses password hashing
apps/api/app/main.py - Company job sources → Public source discovery: provides job feeds
README.md - Public source discovery → Job source adapters: dispatches fetches
apps/api/app/services/job_ingestion/public_sources.py - Job source adapters → Job normalization and persistence: saves normalized jobs
apps/api/app/services/job_ingestion/bulk.py - Job normalization and persistence → PostgreSQL records: writes jobs
apps/api/app/services/job_ingestion/persist.py - Company job sources → Board fetching: supplies board data
README.md - Board fetching → Poller normalization: normalizes fetched jobs
- Poller normalization → Poller writes and state: provides normalized jobs
apps/api/app/ingestion/poller/repository.py - Poller writes and state → PostgreSQL records: writes job records
apps/api/app/ingestion/poller/repository.py - Poller scheduling → Board fetching: schedules polling
- REST API → Resume parsing: supports resume parsing
README.md - REST API → Job matching: serves ranked matches
README.md - Job matching → PostgreSQL records: filters job corpus
README.md - Job matching → AI provider client: requests AI ranking
apps/api/app/services/job_matching.py - AI provider client → LLM providers: sends completions
apps/api/app/services/ai_client.py - REST API → Resume tailoring: supports per-job tailoring
README.md - REST API → Resume export: exports resume versions
apps/api/app/main.py - Ingestion worker → Background job tracking: updates job status
apps/api/app/workers/ingestion.py - Ingestion worker → PostgreSQL records: ingests jobs
apps/api/app/workers/ingestion.py - Matching worker → Background job tracking: updates job status
apps/api/app/workers/matching.py - Matching worker → Job matching: runs matching
apps/api/app/workers/matching.py - Redis queue → Ingestion worker: dispatches work
- Redis queue → Matching worker: dispatches work