Home

JobRadar

One inbox for every job posted in the Telegram groups you follow: deduplicated, ranked, and ready to apply.

JobRadar is an open-source, self-hosted agent. It reads the job channels you follow, turns every job link into one row in a Notion database, and fills in the details (company, role, location, skills, salary, deadline) using an LLM. You review and apply yourself; JobRadar never applies for you.

Status: v0.1 (Telegram → Notion, dedupe, ad filtering) and v0.2 part A (page reading with Gemini) are working. Match scores, resumes and email alerts are next. See Roadmap.

Start here

If you want to…	Read
Install it and see jobs in Notion	Getting Started
Set up the Notion database correctly	Notion Setup
Change channels, filters, LLM or link rules	Configuration
Know what each command does	Commands
Understand what happens to a post	How It Works
Fix an error	Troubleshooting
Quick answers	FAQ

What it does today

• Reads Telegram channels as you, read-only, catching up on anything posted while it was off.
• One job, one row. The same link posted in ten groups becomes one Notion row with a "Seen In" count.
• Hides channel ads (WhatsApp groups, YouTube, course and app links) automatically.
• Reads each job page and has Gemini fill the Notion columns, within a daily budget (default ₹15, about 150 jobs).
• Reports posts, jobs, duplicates and hidden ads with jobradar stats.

Design documents

The full specs live in the repository: PRD · HLD · LLD · Plan · Security policy