LEADFinder
By Devaxio
AI-powered lead discovery engine — scrapes, ranks, and drafts replies across
8+ platforms so you never miss a client.
LEADFinder is a full-stack localhost application that turns the chaos of 8 different platforms into one clean, brutalist dashboard. It scrapes Reddit, Craigslist, Upwork, Google Alerts, Mastodon, Indeed, and Hacker News — then uses AI to rank leads by budget/urgency and draft personalized replies from your uploaded resume.
Zero monthly cost. Runs on your machine. Scales with your team.
/// live pipeline — jobs streaming in from 8 platforms, ranked by AI ///
# 1. Download Python from https://www.python.org/downloads/ (check "Add Python to PATH")
# 2. Verify it's installed:
python --version
# 3. Upgrade pip (optional but recommended):
python -m pip install --upgrade pip# Debian / Ubuntu / Mint:
sudo apt update && sudo apt install python3 python3-pip python3-venv -y
# Fedora:
sudo dnf install python3 python3-pip -y
# Arch:
sudo pacman -S python python-pip --noconfirm
# Verify:
python3 --version && pip3 --version# 1. Install backend dependencies
pip install -r requirements.txt
# 2. Install frontend dependencies
cd frontend && npm install && cd ..
# 3. Launch both servers
python run.pyThen open http://localhost:5173 — the backend API docs live at http://localhost:8000/docs.
Tip
First run? Create an account, upload your resume (AI auto-parses it), then head to Settings → Presets to pick a search configuration. Full workflow in the Launch Guide.
| Layer | Technologies |
|---|---|
| Backend |     |
| AI / LLM |     |
| Frontend |     |
| Scraping |     |
| Infra |    |
LEADFinder/
├── backend/ # FastAPI application
│ ├── ai/ # AI clients + draft generator
│ │ ├── openrouter_client.py
│ │ ├── github_client.py
│ │ └── draft_generator.py
│ ├── routers/ # API endpoints
│ │ ├── auth.py # Login / register / OAuth
│ │ ├── leads.py # CRUD + ranking
│ │ ├── replies.py # Drafts + send + retry
│ │ ├── settings.py # Budgets / limits / keywords
│ │ └── ai_config.py # Model provider config
│ ├── scrapers/ # Source-specific scrapers
│ │ ├── reddit.py
│ │ ├── craigslist.py
│ │ ├── upwork.py
│ │ ├── mastodon.py
│ │ ├── indeed.py
│ │ ├── hackernews.py
│ │ └── google_alerts.py
│ ├── utils/ # Ranking, currency formatting
│ ├── main.py # FastAPI entry point
│ ├── database.py # SQLAlchemy config
│ └── models.py # DB schemas
│
├── frontend/ # React application
│ ├── src/
│ │ ├── components/ # UI components
│ │ │ ├── Auth/
│ │ │ ├── Dashboard/
│ │ │ ├── Layout/ # Sidebar, Header
│ │ │ ├── Leads/
│ │ │ ├── Settings/ # Tabbed settings page
│ │ │ └── Profile/
│ │ ├── hooks/ # useAuth, useSettings, useLeads
│ │ └── services/
│ │ └── api.js # Axios instance
│ ├── package.json
│ └── vite.config.js
│
├── assets/ # Images, screenshots
├── requirements.txt # Python dependencies
└── run.py # One-command launcher
- Multi-Platform Scraping
- 8 sources — Reddit, Craigslist, Upwork, Google Alerts, Mastodon, Indeed, Hacker News. Each runs on its own schedule with configurable rate limits.
- AI-Powered Ranking
- Leads are auto-ranked Hot / Warm / Cold based on budget keywords and urgency signals. Budgets converted to MAD for comparison.
- Resume-Aware Drafting
- Upload your resume once — AI parses your name, portfolio, pricing, skills, and tone. Every draft is personalized and on-brand.
- Kanban & List Views
- Toggle between chronological list, Kanban board (New → Drafted → Replied → Archived), or split view for high-volume triage.
- Configurable Everything
- Budget ranges, rate limits, keyword boosts/blacklists, AI models, search presets — all editable from the Settings panel.
- Multi-User Ready
- 1 admin + 2-3 team members. OAuth (Google/GitHub) or email/password auth. Local SQLite — no cloud costs.
- Open localhost:5173 and create an admin account
- Go to Profile and upload your resume — AI parses it instantly
- Go to Settings → Presets and pick a search preset (or create your own)
- Configure Connection Center with your API keys (Reddit, Gmail, etc.)
- Set Budget & Limits to match your workflow
- Dashboard populates automatically as scrapers find leads
| ⚡ Full Dashboard | 🔨 17+ Built-in Tools |
|---|---|
 |
 |
| Rank, filter, bulk-edit, and track every lead from one brutalist cockpit | Word counter, QR generator, JSON formatter, invoice generator & more — all free |
| 📄 ATS Resume Checker | 🧾 Invoice Generator |
|---|---|
 |
 |
| Paste any job description — Our Algorithm scores your resume and highlights skill gaps | Create branded PDF invoices with one click, ready to send |
Built with ■ by
Devaxio
LEADFinder — 2026 — Local-first — AI-native