git404hub

what is ghost-agent fr?

sh1618112233/ghost-agent — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 4/5Setup · hard

tl;dr

An automation agent that scrapes job listings, scores them against your resume with a locally run AI model, and reaches out to recruiters via WhatsApp or email.

vibe map

mindmap
  root((repo))
    What it does
      Scrapes jobs
      Scores resume fit
      Contacts recruiters
    Tech stack
      Python
      Playwright
      Ollama
    Use cases
      Job search automation
      Lead tracking
    Audience
      Job seekers
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Automatically scrape and filter job listings above a salary threshold.

VIBE 2

Score job postings against your resume with a locally run AI model.

VIBE 3

Send automated outreach messages to recruiters over WhatsApp or email.

VIBE 4

Track and export job leads to a CSV file for manual review.

what's the stack?

PythonPlaywrightOllamaSQLiteTelegram Bot API

how it stacks up fr

sh1618112233/ghost-agent0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyhardmoderatemoderate
Complexity4/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Requires Ollama running locally with a pulled model, plus Playwright's Chromium browser.

in plain english

Ghost Agent is a tool that automates the repetitive parts of looking for a job. It scrapes job listings from job sites, uses an AI model that runs on your own computer through Ollama to judge how well each listing matches your resume, and then reaches out to recruiters for you over WhatsApp or email. You can control it either from the command line or through a Telegram bot. Because the AI scoring runs locally on your machine, your resume and the job details it collects never get sent to an outside AI service, and no third party AI API key is needed. Right now Naukri, a job site aimed mostly at the Indian market, is the only platform fully supported and actively maintained. Support for Glassdoor, Indeed, and Foundit exists in the code but is described as still under development and may not fully work yet. The overall flow is: the tool searches for jobs while skipping listings below a minimum salary you set, scores each one against your resume using the local Ollama model on a scale of one to ten, pulls out a recruiter's phone number or email from the listing, and then sends an outreach message. It tries WhatsApp first, using a saved browser login so you only need to scan the QR code once, and falls back to email if there is no valid phone number. Every lead is saved to a local SQLite database with its current status, such as contacted, invalid number, or send failed, and the whole list can be exported to a CSV file for review in a spreadsheet. To run it you need Python 3.10 or newer, Ollama installed with a small local model pulled in advance, and the Playwright browser tool, which the setup scripts install automatically. Telegram and email outreach are both optional and only needed if you want those specific features. Setup scripts are provided for Windows, Linux, and macOS.

prompts (copy fr)

prompt 1
Help me set up Ghost Agent with Ollama and Playwright on Linux.
prompt 2
Explain how Ghost Agent's resume matching score from one to ten is calculated.
prompt 3
Help me add support for scraping Indeed to Ghost Agent's scraper.py.
prompt 4
Write a Telegram bot command that triggers Ghost Agent's job hunt workflow.

Frequently asked questions

what is ghost-agent fr?

An automation agent that scrapes job listings, scores them against your resume with a locally run AI model, and reaches out to recruiters via WhatsApp or email.

What language is ghost-agent written in?

Mainly Python. The stack also includes Python, Playwright, Ollama.

How hard is ghost-agent to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is ghost-agent for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.