How niihhhall/subreach works
Subreach discovers Reddit prospects, qualifies and researches them, drafts personalized replies, checks compliance, and stores approved drafts for human review. The dashboard is a read-only view of leads, the review queue, handoffs, scout results, accounts, and health; sending is a separate backend capability. The README documents Scout and account-warm-up swarm alongside the main workflow. Some connections are based on README descriptions because their implementation was not sampled.
Main entry points: orchestrator.py Pipeline Orchestrator · reddit_client.py Reddit Access · llm.py LLM Adapter · research.py Thread Research
Components 23
Lead Pipeline
- Pipeline Orchestrator
reddit_outreach/orchestrator.py - Lead Discovery
reddit_outreach/agents/discovery.py - Fit & Intent
reddit_outreach/agents/qualification.py - Thread Research
reddit_outreach/agents/research.py - Personalization
reddit_outreach/agents/personalization.py - Compliance Check
reddit_outreach/agents/compliance.py
Safety & Operations
- Subreddit Scout
reddit_outreach/agents/scout.py - Warm-Up Swarm
reddit_outreach/swarm.py - Account Health
reddit_outreach/health.py - Rate & Pacing
reddit_outreach/pacing.py - Outreach Sender
reddit_outreach/sender.py
Backend & State
- Reddit Access
reddit_outreach/reddit_client.py - LLM Adapter
reddit_outreach/llm.py - Lead & Activity Store
reddit_outreach/store.py - Read API
reddit_outreach/api.py
Read-Only Dashboard
- Dashboard Shell
dashboard/src/App.tsx - Dashboard Views
dashboard/src/pages - Data Hooks
dashboard/src/hooks - API Client
dashboard/src/lib/api.ts
Other components
- Operator
- LLM Providers
- Dashboard User
Connections 30
- Operator → Pipeline Orchestrator: runs pipeline
- Pipeline Orchestrator → Lead Discovery: runs discovery
- Lead Discovery → Reddit Access: searches posts
- Reddit Access → Reddit: reads Reddit
- Pipeline Orchestrator → Fit & Intent: qualifies leads
- Pipeline Orchestrator → Thread Research: researches threads
- Thread Research → Reddit Access: reads threads
- Pipeline Orchestrator → Personalization: drafts replies
- Pipeline Orchestrator → Compliance Check: checks drafts
- Fit & Intent → LLM Adapter: requests analysis
- Thread Research → LLM Adapter: requests analysis
- Personalization → LLM Adapter: requests drafting
- Compliance Check → LLM Adapter: requests review
- LLM Adapter → LLM Providers: calls provider
- Pipeline Orchestrator → Lead & Activity Store: persists stages
- Pipeline Orchestrator → Subreddit Scout: runs scout
- Subreddit Scout → Reddit Access: discovers subs
- Subreddit Scout → Lead & Activity Store: stores findings
- Pipeline Orchestrator → Warm-Up Swarm: runs warm-up
- Pipeline Orchestrator → Account Health: checks health
- Pipeline Orchestrator → Outreach Sender: dispatches sends
- Outreach Sender → Rate & Pacing: checks limits
- Outreach Sender → Reddit Access: posts outreach
- Read API → Lead & Activity Store: reads state
- Dashboard User → Dashboard Shell: views dashboard
- Dashboard Shell → Dashboard Views: routes views
- Dashboard Views → Data Hooks: loads data
- Data Hooks → API Client: requests data
- API Client → Read API: fetches JSON
- Dashboard Views → Dashboard User: shows results