Birddog

Automated job search agent system with three components:

1. Job Finder — Discovers jobs matching filter criteria via SerpAPI, LinkedIn, and Greenhouse APIs
2. Job Agent — Telegram bot for reviewing jobs, auto-applying, tracking applications in Google Sheets, and monitoring Gmail for status updates
3. Application Drafter — Tailors CVs and drafts cover letters from source materials, delivers via Telegram

Setup

uv sync
cp .env.example .env                              # fill in API keys
cp config/settings.example.toml config/settings.toml      # tune filters and weights
cp config/companies.example.toml config/companies.toml    # list your target companies

Create your personal materials from the templates in materials/ — see materials/README.md for the file list.

Run

uv run birddog              # start the bot
uv run birddog --auth-only  # complete Gmail OAuth and exit
uv run pytest -q                 # run tests

Deploy

Built for Railway with a persistent volume mounted at /data. See Dockerfile and railway.toml. The BIRDDOG_DATA_DIR env var controls where the SQLite DB, drafts, and Gmail token live.