ethany14 / Eregion-Job-Finding-Agent
git clone https://github.com/ethany14/Eregion-Job-Finding-Agent.git
Your job landing in one conversation
+23
stars, 24h · #1,651
+~161
stars, 7 days · #1,354
+~690
stars, 30 days · #1,211
49
★ total · +161% this week
5
forks · 0 open issues
Star history (as recorded here)
LanguagePython
LicenseMIT
Created2026-09-13 (1mo ago)
Last push2d ago
Watchers1
OwnerUser
GitHub topics
agentagent-frameworkagent-skillsagenticagentic-aiagentic-workflowagentloopapplyapply-integrationautofillautofill-frameworkautofillerjob-boardjob-searchjob-trackerworkflowworkflow-automationworkflow-orchestrationworkflows
Links
- GitHub: github.com/ethany14/Eregion-Job-Finding-Agent
- Homepage: https://ethany14.github.io/Eregion-Job-Finding-Agent/
- Releases · Issues · Hacker News mentions
README excerpt
English · 简体中文 Get started · User guide · Configuration · Evaluation · Website --- Eregion is a job-search agent that runs on your computer. Tell it what you are looking for and it searches company job boards and LinkedIn, reads each posting in full, and comes back with jobs sorted by how well they fit your resume. Each job lists its gaps and what you still need to confirm. It also tailors your resume and cover letter, fills in application forms in Chrome up to the review page, and helps you practise for interviews. Everything stays in a local database. Model work uses the API key you provide, and **nothing is ever submitted without you**. ## A workspace for the whole search 💬 Council Your conversations with the agent. Results arrive as cards with their tier, reason, gaps and next step. 📖 Chronicle Home: what happened today, and which conversations are waiting on you. 🛤️ The Road Every application on one map, board or table, with response rates. ⚒️ The Forge Materials are drafted , tempered (each claim checked against your resume) and sealed when you approve them. Job alerts run recurring searches and send you digests, and **The Lookout** shows the agent's browser so you can take control. Switch between parchment **Day** and holly-green **Night**, and between **English and Simplified Chinese** (中文), from the sidebar. The language choice is remembered in your browser; a Chinese browser starts in Chinese. ## How a job search works Ask in plain words, for example *“Find senior backend roles, remote in the US, for my resume.”* The agent: 1. **Searches** the verified company-board directory and LinkedIn, mixing results across employers. 2. **Reads each posting in full** and checks it against what you asked for: role, location, level, and whether the opening is current. Only clear mismatches are dropped, such as a different occupation, a Staff role when you asked for senior, or a city you ruled out. A near miss is kept, with the difference stated. 3. **Scores fit** against your resume, using your main model or optional Jev. Scoring that runs under a budget is saved in small batches, so a budget stop keeps every finished score. 4. **Sorts the results into three tiers**, each with evidence quoted from the posting: | Tier | Means | | :-- | :-- | | **Priority match** | Role, location and level match, and your resume shows the core requirements. | | **Worth trying** | Relevant, but a core skill or experience isn't on your resume. Each gap is listed with how much it matters. | | **Needs your confirmation** | Something only you can answer: GPA, work authorization, start date, or a level or location the posting doesn't make clear. | There is no quota and no padding with weak matches. Only jobs the agent saved as recommendations can appear under a tier; jobs that were not scored, or were scored and set aside, are listed separately as such. The reply says what was searched, what failed and what is left, and you can reply *“search more”