Reddit Growth Copilot

Reddit Growth Copilot is an open-source Reddit growth intelligence copilot for overseas SaaS products, AI tools, creator tools, indie hackers, and growth teams.

It helps you discover relevant subreddits, monitor public Reddit posts, identify user pains and buying intent, draft natural English Reddit replies for human review, and turn Reddit conversations into daily and weekly growth insights.

Who It Is For

• SaaS founders validating a market or category
• AI tool builders looking for real user pain
• creator tool teams studying workflows and objections
• indie hackers doing ethical community research
• growth operators who need repeatable Reddit intelligence

What It Does

• discovers subreddits that match your product, audience, and pain points
• collects Reddit posts through public RSS feeds
• analyzes intent, pain intensity, response gap, opportunity score, and promotion risk
• generates multiple English comment drafts:
  • helpful_expert
  • founder_perspective
  • no_product_mention
  • soft_product_mention
• creates Markdown daily reports and weekly reviews
• stores data locally by default
• optionally writes records to Feishu/Lark Bitable and pushes digest messages

What It Will Not Do

This project is intentionally conservative:

• it will not automatically post Reddit comments
• it will not automatically send private messages
• it will not upvote, downvote, or manipulate engagement
• it will not create fake accounts, fake conversations, or spam
• it only listens, analyzes, drafts, reports, and helps you review

Professional Metrics Framework

Reddit growth is not just about upvotes. A post with many upvotes may be impossible to participate in safely, while a small thread with a clear unanswered pain may be highly valuable.

This project tracks:

• community fit: whether the subreddit audience matches your product
• opportunity density: how often useful participation opportunities appear
• response gap: whether a thread still needs a helpful answer
• pain intensity: how strongly users express frustration or urgency
• promo risk: how likely a reply may be perceived as self-promotion
• engagement quality: reply survival, positive replies, and useful conversation
• learning velocity: how fast Reddit conversations improve product and messaging decisions

Core formulas are implemented in reddit_growth_copilot/metrics/scoring.py.

Quick Start

git clone https://github.com/yourname/reddit-growth-copilot.git
cd reddit-growth-copilot
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
rgc init

On Windows PowerShell:

git clone https://github.com/yourname/reddit-growth-copilot.git
cd reddit-growth-copilot
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev]"
rgc init

Then edit:

• .env: add OPENAI_API_KEY
• config.yaml: add your product, keywords, competitors, target users, and subreddits

Run:

rgc doctor
rgc discover
rgc daily
rgc weekly

Local-Only Mode

Local mode is the default:

storage:
  mode: local

Data is written to:

• data/raw_posts/
• data/opportunities/
• data/discovery/
• data/reports/
• data/weekly/

If Feishu/Lark configuration is incomplete, the app falls back to local storage and prints a friendly warning.

Feishu / Lark Setup

Set:

FEISHU_APP_ID=
FEISHU_APP_SECRET=
FEISHU_BASE_APP_TOKEN=
FEISHU_POSTS_TABLE_ID=
FEISHU_OPPORTUNITIES_TABLE_ID=
FEISHU_SUBREDDITS_TABLE_ID=
FEISHU_WEEKLY_TABLE_ID=
FEISHU_BOT_WEBHOOK=

Then enable Feishu in config.yaml:

storage:
  mode: both

integrations:
  feishu:
    enabled: true
    push_daily_digest: true
    push_weekly_report: true

Recommended Bitable tables:

• Posts
• Opportunities
• Subreddits
• Weekly_Insights

Scheduled Runs

Cron example:

0 9 * * * cd /path/to/reddit-growth-copilot && . .venv/bin/activate && rgc daily
0 10 * * 1 cd /path/to/reddit-growth-copilot && . .venv/bin/activate && rgc weekly

GitHub Actions can run the same commands on a schedule. Store secrets such as OPENAI_API_KEY and Feishu keys in GitHub Actions secrets, not in the repository.

Development

pip install -e ".[dev]"
python -m pytest

Contributing

Issues and pull requests are welcome. Please keep the project aligned with its ethical boundary: monitoring, analysis, drafts, insights, and review only.

License

MIT