IdeaMine

IdeaMine (ideamine) is a local-first Python CLI and Streamlit app for turning Reddit pain points into buildable product ideas, competitor checks, and lightweight validation briefs.

What It Does

• Discovers tech-relevant subreddits from seed keywords
• Mines complaint-heavy posts and ranks them by signal
• Generates evidence cards or screenshots for top complaints
• Produces competitor search links for fast market scans
• Runs waitlist experiments and LLM-generated idea briefs

Quickstart

Install

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -e ".[ui,reddit]"

Optional extras:

pip install -e ".[ui,reddit,screenshots,dev]"
playwright install

Configure Secrets

Use a local .env file for API keys and Reddit credentials:

Copy-Item .env.example .env

Then edit .env and set at least:

• OPENAI_API_KEY for LLM briefs
• REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USER_AGENT for more reliable Reddit access

Do not commit .env.

Initialize The Workspace

python -m ideamine init

Run The App

Windows launchers:

• run_ui.bat starts the Streamlit dashboard
• run_all.bat runs the pipeline-oriented CLI flow

Manual Streamlit launch:

python -m streamlit run ui\app.py

CLI Flow

Discover and select subreddits:

python -m ideamine subreddits discover --keywords saas,automation,workflow,chrome,api,developer,productivity --top 25
python -m ideamine subreddits auto-select --n 7

Mine complaints and write the ranked report:

python -m ideamine mine --windows month --limit 100
python -m ideamine report

Generate evidence:

python -m ideamine evidence cards --max 100
python -m ideamine evidence screenshot --max 100

Create briefs and competitor links:

python -m ideamine competitors links --complaint 1
python -m ideamine llm analyze --complaint 1
python -m ideamine llm batch --top 50 --categories software,unknown

Run a waitlist experiment:

python -m ideamine waitlist create --complaint 1 --google-form-url "https://docs.google.com/forms/d/e/..."
python -m ideamine waitlist ingest --campaign 1 --csv path\to\responses.csv

Project Layout

• ideamine/ core package
• ui/ Streamlit app
• scripts/ Windows-friendly helper scripts
• tests/ pytest suite
• config.yaml local workspace config created by ideamine init
• data/ local SQLite database and runtime state
• artifacts/ generated reports, briefs, cards, and screenshots

Notes

• Package name: ideamine
• Public-facing product name: IdeaMine
• Recommended repo name: ideamine
• Runtime data is intentionally kept out of git via .gitignore