v1.3.0 — the wide net

Three more sources joined the hunt, and the same gig stopped wearing five hats.

• 👽 Reddit connector — [Hiring] posts from your subreddits (public JSON, honest UA, 5-min floor). [For Hire] ads skipped by design; per-sub source tagging feeds the funnel.
• 🌐 Guru.com + PeoplePerHour — public job RSS via shared board plumbing; bot-wall responses surface as honest, actionable errors.
• ⧉ Cross-source dedup — normalized title × money bucket fingerprint; second sightings bump the original and remember the board instead of cloning rows or re-buzzing your pocket.

Full notes in CHANGELOG.md.

v1.2.0 — the closer's copilot

The chase stopped being manual.

• 🔁 Follow-up bumps — every shot auto-schedules a +3-day nudge; one click generates 3 honest sentences and copies them for you to paste. Any verdict cancels the chase.
• 🎤 Interview kit — gig gaps become your questions, the money frame anchors above your floor, talking points tie skills to YOUR highlights, red flags become named red lines.
• 💼 Money ledger — record what you quoted; the ledger values pipeline and wins at YOUR number, with monthly bars. /money in the pocket.

Full notes in CHANGELOG.md.

v1.1.0 — the learner

The learner release. The scope stopped guessing.

• 🧠 Win-memory — won/lost outcomes snapshot into memory; lookalike gigs get a capped ±10 nudge (rapidfuzz, difflib fallback)
• 🛡 Price guard — EUR/GBP → USD normalization, half-your-floor lowballs take −5 and get named, money reads carry a confidence
• ✅ Qualification checklist — six honest yes/no/unknown lines before you approve (one tap on the board, or GET /api/jobs/{id}/checklist)
• ⌖ Queue ranking v2 — rank = score × freshness × source trust; the pending column orders by urgency, /api/queue serves it

Full notes in CHANGELOG.md.

v1.0.0 — the machine gun

leadhound is now working as it was meant to work: the gig drops, your phone buzzes, you fire. 1.0 because the missing pieces were speed and survival, not features.

📡 Freelancer webhook — seconds, not polls

Register the receiver URL + signing secret in the developer portal and new projects flow straight into the pipeline: scored, drafted, pushed, per user. HMAC-SHA256 verified against the raw body (constant-time, all common header variants), guid dedupe so the poller never double-pushes. One-click secret rotation — the old secret dies instantly, the new one is shown exactly once. Live event counters on the 📡 card and in /api/radar.

⏰ Downtime catch-up

Sleep 8 hours and the hound wakes up and catches up: if the last sweep is over an hour old at boot, the first sweep backfills the blackout and flags everything you missed with an amber ⏰ late chip. Timezone-aware comparison — no format lies.

💓 Radar heartbeat + 🐕 watchdog

The poller lands a heartbeat after every sweep; thread_alive checks the actual thread, and stalled fires when the heartbeat goes quiet for 3x the interval. /api/health is real vitals now (db, uptime, poller, listeners — aggregate only). A watchdog supervisor relaunches dead poller threads with exponential backoff (15-min cap), respawns dead pocket bots from the db arm-state, and respects shutdown above all.

⚡ Polite fast lane

RemoteOK / Remotive / WWR / HN / custom RSS now poll on a 2-minute floor, paying their way with ETag + Last-Modified conditional GET — an unchanged feed costs a 304 and nothing else. Keys/cookie/search connectors keep their 5-minute floor (Connector.min_poll is the per-source truth), and ±20% jitter keeps a fleet of hounds from stamping a source in unison.

🤫 /ping heartbeat board

One command, all of ops: ✅ healthy sources with cadence + tick age, 🟡 overdue or never swept, ❌ erroring with the reason, the radar thread's own pulse, and the webhook armed state with rejected-signature warnings.

Install: pipx install leadhound or docker compose up — then leadhound web, connect sources, arm the pocket sniper.

5 assets: wheel, sdist, Windows / macOS / Linux binaries. 380+ tests, ruff clean, CI green on every commit.

v0.9.1 — the routine

v0.9.1 the routine — v0.9.0 put the sniper in your pocket; v0.9.1 makes the daily grind disappear.

Added

• 🌓 Dark/light theme — the console adapts to daylight; choice persists, no flash on reload
• 📲 Installable pocket console — PWA manifest + shell-caching service worker + sniper-scope icon; live API data is never cached. Installs to your phone's home screen
• ⚡ Auto-snipe rules — min score (60–99) + keywords + source + budget caps auto-approve matching gigs with an ⚡ auto badge. Guardrail honest: rules never auto-bid — firing stays behind a human click
• ✨ improve-draft — one-click rewrite: LLM in your voice, or zero-config template sharpening (closing question, concrete plan, budget ack — keeps every custom line)
• 📦 Starter packs — six one-click niche bundles (dev / design / marketing / support / product / firehose) on verified WWR + Remotive feed channels; your existing settings are kept
• 🤖 Pocket bot /digest + /ping — the whole board (counts, rates, top 3 gigs) and a liveness probe, from your chat
• 💾 Saved views — filter bar with source picker + score bar; name a view, one click back to it
• 🐳 One-container self-host — docker compose up; data on the /data volume, first boot auto-inits
• 🩺 Update checker in doctor — warns (never fails) when a newer release ships

Changed

• 40+ new network-free tests; full suite well past 350

Install: pip install leadhound · Self-host: docker compose up · full notes in CHANGELOG.md

v0.9.0 — the pocket sniper

📱 the pocket sniper release

The board lives on your phone now. Arm the listener, and your Telegram chat becomes the sniper's cockpit.

The two-way bot

• /queue [n] — best pending gigs, score first
• /gig <id> — full card + the drafted proposal
• /approve <id> — move it up the pipeline
• /snipe <id> [amount] — arms a real Freelancer.com bid, shows the plan, waits for your 🔥 Fire tap. Kit-mode sources answer honestly instead. Confirm state is memory-only with a 5-minute TTL — a restart can never leave a half-armed bid.
• /stats — your scoreboard, pocket-sized

Safety rails, honestly built

• chat-gated: a stray /queue from any other chat gets silence, never your data
• sends serialized ~1/s per chat, 429s honor retry_after
• one long-poll bot per account (cap 8), restart-clean, auto-armed on boot
• source breaks (expired cookie, dead token) → the bot tells you once per new failure, never spam

Under the hood

• per-account notify settings (per-user bot tokens replace global config; pre-0.9 config seeds silently)
• per-account push with its own score bar — account A's gigs never buzz account B
• per-source radar cadence (5–120 min clamp) via POST /api/notify/cadence
• dashboard: 📱 telegram card — token, chat id, test message (Telegram's verdict verbatim), arm/disarm
• 30 new network-free tests; 316 total, CI green on every commit in the chain

Full changelog: CHANGELOG.md

---

built by Mayank Bhaskar — github.com/e2sy

leadhound v0.8.0 — the closer's release

Sniping was v0.7.0. v0.8.0 teaches the sniper to count kills — and to learn which ammo wins. 🔥🎯📊

📊 The scoreboard

A new stats tab turns your pipeline into honest numbers, backed by a new account-scoped GET /api/stats:

• Funnel cards — shots fired, reply rate, win rate (of resolved gigs — the honest kind), won value, in-play value, interviews
• Per-source conversion — a bar + reply rate per source. Feed the green rows, prune the dead ones
• 🔥 live-fire vs 🎯 kit — do real API bids reply more than copy-paste kits? Now you know
• 🧠 Scope calibration — winners vs losers by average score, with tightening hints

🎤 Outcomes grow a stage

The funnel is now sent → replied → interview → won/lost. Interviews count as replies everywhere — chips, stats, calibration hints.

⚔ Proposal A/B testing

• Every draft editor has A/B tabs — "⚔ add B" clones your draft in one click
• The snipe dialog grows a version picker; the fired variant is recorded on every sniped card (kit · B / live-fire · B)
• The scoreboard grows a proposal duel panel with a verdict line once both sides have shots
• GET/POST /api/jobs/{id}/variants + per-variant stats

⌨ Keyboard cockpit

j/k aim through the board (wrap-around), a approve, x/r reject, s snipe, o open gig, c copy proposal, d edit draft. Acting auto-aims the next gig so the queue flows. ? shows the shortcut card; keys pause while you type.

📧 Email + 🔔 browser alerts

• Email notifications: plain-SMTP gig cards (score, money, matched skills, red flags, gig link + draft) via the new [email] config section — stdlib only, Gmail app passwords work, leadhound doctor checks the credentials
• Browser bell: opt-in toggle — new gigs raise a native notification (top score + title) while the dashboard is open; click it to jump to the board

Also

• db.stats() / db.calibration() are now account-scoped — accounts no longer see each other's counts
• leadhound stats (CLI) prints a sniper line with reply/win rates
• 265 tests (59 new), ruff clean, CI green on every commit

Install: pip install leadhound · or grab a native binary below (Windows .exe shows a SmartScreen note on unsigned builds — More info → Run anyway)

Full changelog: https://github.com/e2sy/leadhound/blob/main/CHANGELOG.md

---

designed & built by Mayank Bhaskar

v0.7.0 — the sniper release

🎯 The loop is closed

leadhound no longer stops at find → score → draft. v0.7.0 fires with your account — and tracks every shot.

🎯 Snipe mode

Every pending/approved gig card has a snipe button with a fire dialog:

• 🔥 live-fire (Freelancer.com, linked account) — a real bid is placed on Freelancer.com through their official API with your own token. You set the amount + delivery period, hit fire, the platform bid id lands in your board's audit trail. Your account, your trigger, on the books.
• 🎯 snipe kit (every other source) — your proposal in an editable textarea; one click copies it and opens the gig page in your own logged-in session; an honest "✓ sent it" step records the shot. No fake buttons.

🔗 Freelancer.com account link

New card in the accounts hub: official OAuth2 (free dev app → paste keys → 🔗 connect), auto-refreshing token, linked as @you badge. Same two-minute flow as Upwork.

📊 Sniper stats + audit trail

• jobs record sniped_at, method (freelancer-api bid id / kit) and a note — the 🔥 Sniped column shows badges with receipts
• chips for sniped-in-7d and reply rate; outcomes (replied/won/lost) still calibrate the scope
• new API: GET /api/jobs/{id}/snipe-plan · POST /api/jobs/{id}/snipe · POST /api/jobs/{id}/snipe-confirm + Freelancer OAuth flow

🛡️ Still ToS-safe

Bids go through official APIs with your own credentials, only when you click fire — nothing bids in the background. Kit sends happen in your own browser session.

206 tests green · ruff clean · CI/Release/Binaries all passing · verified in-browser with 50 live Freelancer.com gigs

full changelog: CHANGELOG.md

leadhound v0.6.0 — the real-accounts release

v0.6.0 kills the demo-mode feel for good: the app now opens by connecting your job sites, and the landing page itself shows 50 real Freelancer.com gigs fetched live through the new flow.

🔗 Accounts hub (replaces the sources drawer)

A full accounts tab — one card per job site with:

• an honest connection state badge: ✅ connected · ❌ error · 🟡 on — not tested yet · ⚠ setup needed · ⚫ off
• last sweep line: +N new gigs or the actual error text, no pretending
• inline settings, switch on/off, and ⚡ save & test — a real probe that tells you your keys/cookie work before you rely on them

🧙 Setup wizards

• Upwork: step-by-step — create the free dev app → copy the redirect URI (one click) → paste keys → 🔗 connect (official OAuth2, token auto-refreshes forever)
• Fiverr (beta): exact steps to pull your session cookie from DevTools, with the honest warning that Fiverr has no public API

📡 Radar visibility

New GET /api/radar exposes the sniping radar's real state — running, sweep interval, armed sources — and the accounts page shows it as a live heartbeat (📡 radar live · sweeps every 15 min).

✅ First-run connect checklist

The empty board is now a 3-step list — connect a source → fetch real gigs → approve & send — that ticks itself green as you go. The 🎲 sample-data button is demoted to a tiny "just exploring?" link.

⬇️ Downloads

Same zero-setup promise: double-click the binary for your OS → create your account → open 🔗 accounts → switch on Freelancer.com → ⚡ fetch. Real gigs in under a minute, radar keeps hunting while you sleep.

179 tests green · ruff clean · CI verified on Windows/macOS/Linux.

leadhound v0.5.0 — the real-backend release

leadhound just went from a demo prototype to a working prototype: a real backend, a login system, and connectors that let you plug in the work sites you already use — then snipe the gigs from one board.

🔑 Login system

• Register / sign in from the dashboard — scrypt password hashing, HttpOnly session cookies, 30-day sessions.
• Every job board, queue and connector run is account-scoped — your data stays yours.

🔌 Source connectors (the "connect the work sites" part)

Source	How it connects	Status
Freelancer.com	public search API — zero config, works instantly	✅ live (50 real gigs verified in testing)
Upwork	official OAuth2 authorization flow + auto token refresh, GraphQL job search	✅ needs your Upwork API keys
Fiverr	buyer-requests session connector	⚠️ beta, session-cookie based, may break — no official API
RemoteOK / Remotive / WWR / Hacker News	RSS/JSON watchers (already in 0.4)	✅ live
Any custom feed	point it at any RSS URL	✅

Secrets are stored locally, masked (••••••) in the UI and API, and never echoed back once saved.

⚙️ Real backend

• The stdlib demo server is gone — FastAPI + uvicorn now serves a proper REST API (/api/auth/*, /api/state, /api/connectors/*, /api/fetch, interactive docs at /docs).
• One ingest pipeline for everything: connectors → dedupe → scoring → drafts → queue/notifications. The CLI and the dashboard share the exact same path.
• Sniping radar: a background thread re-polls your enabled connectors on a schedule (configurable, min 5 min) so new gigs land in your queue without you asking.

🖥️ Dashboard v2

• Login gate, honest onboarding (no fake data unless you click the demo button).
• New Sources drawer: add connectors, see masked credentials, run any source on demand, one-click Upwork OAuth connect.

⬇️ Downloads

Double-click the binary for your OS → it sets up, opens your browser, and asks you to create the first account. No Python needed.

⚠️ Upwork/Fiverr integrations use their official/semi-official interfaces and are for personal use — read each platform's ToS before automating anything.

176 tests green · ruff clean · CI verified on Windows/macOS/Linux, including a live Freelancer.com fetch from the frozen Windows binary.