How sohamkhrt/opportunity-pulse- works
OpportunityPulse AI turns a candidate’s background into four career-pivot ideas, searches for matching ATS postings, extracts and validates job details, and streams results to an interactive browser UI. The main flow is visible across the API, pipeline, and frontend excerpts; Bright Data search and collector operations are represented as external services. The README documents optional ATS collectors, opt-in collector auto-heal, and additional-job pagination. Source excerpts omit parts of the pipeline, so unshown internal sequencing is not expanded.
Main entry points: main.py FastAPI service · pipeline.py Discovery stream · app.js Discovery UI · pivot_engine.py Career pivot ideas
Components 13
API and runtime
- FastAPI service
backend/main.py - Server settings
backend/config.py
Career discovery
- Career pivot ideas
backend/pivot_engine.py - Discovery stream
pipeline.py
Job sourcing
- ATS job search
pipeline.py - Job extraction
pipeline.py
Browser experience
- Discovery UI
frontend/app.js - Job cards
frontend/app.js - Find more
frontend/app.js
Other components
- Candidate
- Browser
- Bright Data
- Gemini
Connections 17
- Candidate → Discovery UI: enters background
frontend/app.js - Browser → FastAPI service: requests discovery
- FastAPI service → Discovery stream: streams discovery
backend/main.py - FastAPI service → Server settings: checks settings
backend/main.py - Discovery stream → Career pivot ideas: requests pivots
pipeline.py - Career pivot ideas → Gemini: generates pivots
backend/pivot_engine.py - Discovery stream → ATS job search: searches niches
pipeline.py - ATS job search → Bright Data: searches postings
pipeline.py - ATS job search → Job extraction: extracts selected jobs
pipeline.py - Job extraction → Bright Data: runs collector
pipeline.py - Job extraction → Bright Data: repairs collector
readme.md - Discovery stream → FastAPI service: yields events
backend/main.py - FastAPI service → Discovery UI: sends SSE events
frontend/app.js - Discovery UI → Job cards: renders jobs
frontend/app.js - Discovery UI → Find more: requests more
frontend/app.js - Find more → FastAPI service: posts next page
backend/main.py - FastAPI service → ATS job search: fetches more jobs
backend/main.py