Repository navigation
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 | |
| 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.