How samudralaajaykumarrr/sponsor-job-agent works
Sponsor Job Agent is a local, AI-assisted job-discovery and application-preparation product, centered on a dashboard and an opt-in background agent. Its main workflow finds postings, evaluates sponsorship and employment eligibility and job fit, creates and validates a truthful tailored resume, then prepares an application and assists with provider forms while reserving sensitive or final actions for the user. The graph also includes sponsorship intelligence and the dashboard’s cross-cutting read layer. README capabilities guide the workflow; sampled source excerpts are partial, so uncertain internal wiring is omitted.
Main entry points: executor.py Application executor · pipeline.py Job analysis pipeline · orchestrator.py Agent orchestrator · main.py Local dashboard
Components 22
Dashboard and orchestration
- Local dashboard
app/main.py - Pipeline dashboard
app/pipeline_dashboard.py - Agent orchestrator
app/agent/orchestrator.py
Job discovery and screening
- Discovery cycle
app/agent/cycle.py - Discovery providers
app/providers/registry.py - Job analysis pipeline
app/pipeline.py - Job matching
app/matching/roles.py
Sponsorship intelligence
- Sponsorship decision
app/sponsorship/decision.py - Employer evidence registry
app/registry/repo.py - Sponsorship review
app/sponsorship/review_queue.py
Resume generation
- Candidate profile
app/candidate/profile.py - Resume generation
app/resume/generator.py - Resume optimizer
app/resume_optimizer/optimizer.py - Resume quality checks
app/resume_optimizer/quality.py
Application assistance
- Application scheduler
app/applications/scheduler.py - Application executor
app/applications/executor.py - Browser assistance
app/applications/browser_assist.py - Application providers
app/applications/provider_registry.py - Greenhouse canary
app/applications/greenhouse_canary.py - Application records
app/applications/repo.py
Other components
- Job seeker
- Public ATS APIs
Connections 22
- Job seeker → Local dashboard: uses
- Local dashboard → Agent orchestrator: starts or stops
- Local dashboard → Pipeline dashboard: reads dashboard data
- Agent orchestrator → Discovery cycle: runs discovery
- Agent orchestrator → Resume optimizer: optimizes resumes
- Agent orchestrator → Application scheduler: runs preparation
- Discovery cycle → Discovery providers: fetches postings
- Discovery providers → Public ATS APIs: requests job data
- Job analysis pipeline → Job matching: scores fit
- Job analysis pipeline → Sponsorship decision: evaluates sponsorship
- Job analysis pipeline → Candidate profile: loads profile
- Job analysis pipeline → Resume generation: generates tailored resume
- Employer evidence registry → Sponsorship decision: supplies evidence
- Sponsorship review → Sponsorship decision: reads latest decision
- Resume optimizer → Resume quality checks: checks quality
- Application scheduler → Application executor: dispatches executions
- Application executor → Application providers: selects provider
- Application executor → Application records: records execution state
- Application executor → Browser assistance: runs assisted session
- Browser assistance → Application providers: uses provider capabilities
- Greenhouse canary → Application executor: uses execution context
- Greenhouse canary → Application records: records submission outcome