> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nometria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Growth Tools

> Automated lead capture from Reddit, Discord, and GitHub with LLM scoring and outreach drafts.

`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.

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/nometria/growth-tools">
    nometria/growth-tools
  </Card>

  <Card title="PyPI" icon="python" href="https://pypi.org/project/growth-tools/">
    growth-tools on PyPI
  </Card>
</CardGroup>

## Install

```bash theme={null}
pip install growth-tools
```

Or clone for full access to scripts:

```bash theme={null}
git clone https://github.com/nometria/growth-tools
cd growth-tools
pip install -e .
```

## Setup

Copy the example env and fill in your credentials:

```bash theme={null}
cp examples/sample-icp.env .env
```

Required keys:

```bash theme={null}
# 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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
# 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.

```bash theme={null}
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.

```bash theme={null}
# List hot leads
growth-crm

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

## Lead scoring

| Score  | Tier    | Action             |
| ------ | ------- | ------------------ |
| 80–100 | Hot     | Immediate outreach |
| 60–79  | Nurture | Add to sequence    |
| 40–59  | Educate | Content only       |
| \< 40  | Skip    | Ignore             |

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.

```sql theme={null}
-- From growth-tools/schema.sql in the GitHub repo
```