Social Search

Research agent that searches Reddit and Bluesky using GPT-5.2 with high reasoning.

How It Works

1. Stage 1: Generates 3 search queries for your task
2. Stage 2: Runs 3 parallel LLM instances, each making tool calls to search and gather data
3. Stage 3: Compiles findings into a comprehensive report

Setup

# Clone
git clone https://github.com/yourusername/social-search.git
cd social-search

# Install
pip install -r requirements.txt

# Configure
cp example.env .env
# Edit .env with your credentials

Environment Variables

Usage

CLI

# Reddit only (default)
python agent.py "What are Python best practices in 2024?"

# Both sources
python agent.py "AI trends" --sources reddit bluesky

# No TUI (for scripts)
python agent.py "Query" --no-tui

Interactive

python agent.py
# Prompts for task and sources

Programmatic

from agent import run_agent

report = run_agent(
    "What are Python best practices?",
    sources=["reddit"],
    show_tui=False
)
print(report)

Tools Available

License

MIT