How raghu1134/ai-job-agent works
AI Job Agent is a self-hosted job-discovery and matching service. Its main workflow runs on a schedule or on demand: search job boards, filter and deduplicate adverts, score candidates against the user’s profile with Ollama, record seen jobs, save matches to NocoDB, and send a Telegram summary. The repository implements much of this workflow in one file, so several stage nodes share its path. The setup-check and chat-ID tools support configuration. Relationship evidence is limited to the excerpts and README; unsampled implementation details are not inferred.
Main entry points: finder.py Job Finder · check_setup.py Connection check · get_chat_id.py Chat ID lookup · config.json Run schedule
Components 15
Job discovery
- Job Finder
jobagent/app/finder.py - Run schedule
jobagent/app/config.json - Board search
jobagent/app/finder.py - Reed API
- Adzuna API
- Filter and dedupe
jobagent/app/finder.py
Matching and state
- User profile
jobagent/cv/master.md - AI scoring
jobagent/app/finder.py - Ollama model
- Seen-job state
jobagent/app/finder.py
Results delivery
- NocoDB tracker
- Telegram bot
Setup tools
- Connection check
jobagent/tools/check_setup.py - Chat ID lookup
jobagent/tools/get_chat_id.py
Other components
- Job seeker
Connections 20
- Job seeker → Job Finder: runs
README.md - Run schedule → Job Finder: sets run times
jobagent/app/finder.py - Job Finder → Board search: starts search
jobagent/app/finder.py - Board search → Reed API: queries
jobagent/app/finder.py - Board search → Adzuna API: queries
jobagent/app/finder.py - Job Finder → Filter and dedupe: filters candidates
jobagent/app/finder.py - Job Finder → Seen-job state: reads and saves
jobagent/app/finder.py - Job Finder → User profile: loads
jobagent/app/finder.py - Job Finder → AI scoring: scores candidates
README.md - AI scoring → Ollama model: requests scores
jobagent/app/finder.py - Job Finder → NocoDB tracker: saves matches
README.md - Job Finder → Telegram bot: sends summary
README.md - Job seeker → Connection check: checks setup
README.md - Connection check → Reed API: tests connection
jobagent/tools/check_setup.py - Connection check → Adzuna API: tests connection
jobagent/tools/check_setup.py - Connection check → Ollama model: checks model
jobagent/tools/check_setup.py - Connection check → NocoDB tracker: tests connection
jobagent/tools/check_setup.py - Connection check → Telegram bot: tests connection
jobagent/tools/check_setup.py - Job seeker → Chat ID lookup: looks up chat
README.md - Chat ID lookup → Telegram bot: reads updates
jobagent/tools/get_chat_id.py