Skip to main content
growth-tools automates lead capture from Reddit, Discord, and GitHub — with hybrid LLM scoring, intent classification, and outreach draft generation. Built for dev-tool and SaaS companies that want inbound signal from developer communities.

GitHub

nometria/growth-tools

PyPI

growth-tools on PyPI

​
Install

pip install growth-tools
Or clone for full access to scripts: 
git clone https://github.com/nometria/growth-tools
cd growth-tools
pip install -e .

​
Setup

Copy the example env and fill in your credentials: 
cp examples/sample-icp.env .env
Required keys: 
# Reddit lead capture
REDDIT_CLIENT_ID=...
REDDIT_CLIENT_SECRET=...

# LLM scoring
OPENAI_API_KEY=...

# Lead storage
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_ROLE_KEY=eyJ...

# Discord bot (optional)
DISCORD_TOKEN=...

​
Five systems

​
1. Reddit monitor

Scans subreddits for pain signals, classifies intent with LLM, scores leads, and optionally drafts replies. 
growth-reddit
# or: python -m growth_tools.systems.reddit_capture
Scanned subreddits by default: replit, lovable, nocode, SaaS, webdev.

​
2. Discord trigger bot

Listens for pain phrases, pre-filters with keywords, then classifies with LLM. Replies when confidence exceeds threshold. 
python -m growth_tools.systems.discord_bot

​
3. GitHub repo auditor

Analyzes a repo’s file tree and detects stack, missing production items, and migration opportunities. 
# API
POST /audit/github  {"repo_url": "https://github.com/owner/repo"}

# CLI
python -m growth_tools.systems.github_auditor https://github.com/owner/repo

​
4. Website auditor

Fetches any URL, detects stack from HTML/headers, returns production-readiness risks. 
growth-api
# or: uvicorn growth_tools.api.main:app --port 8000

# Then:
POST /audit/website  {"url": "https://myapp.com"}

​
5. CRM + outreach sequencer

All captured leads land in lead_signals. The CRM pipeline tracks status and generates outreach drafts. 
# List hot leads
growth-crm

# Next actions for a specific lead
growth-crm <lead_id>

​
Lead scoring

ScoreTierAction
80–100HotImmediate outreach
60–79NurtureAdd to sequence
40–59EducateContent only
< 40SkipIgnore
Score factors: builder detected (Lovable/Replit/Bolt), pain type (deploy/migrate/ownership), has_repo, mentions_clients, LLM intent score.

​
Database schema

Run schema.sql in your Supabase SQL editor to create the lead_signals table. 
-- From growth-tools/schema.sql in the GitHub repo