reddit-consensus 0.1.0

Autonomous AI agent for tasteful recommendations via Reddit community analysis

Reddit Consensus Agent

An autonomous AI agent that provides tasteful insights by analyzing Reddit discussions and community feedback.

---

Features

• Elegant Console UI: Clean side-by-side dashboard with responsive layout
• Async Parallel Tool Execution: Uses asyncio for fast, concurrent Reddit API calls
• Two-Phase Research: Initial research followed by critical analysis
• Community-Driven: Analyzes real Reddit discussions and user opinions
• Balanced Insights: Provides both pros and cons based on community feedback
• Configurable AI Models: Uses gpt-4.1-mini by default, but supports other OpenAI models via config.py

Architecture

• Agent State Management: Tracks research progress and findings
• Reddit Tools: Async tools for searching posts and analyzing comments
• Prompt Templates: Centralized prompts for consistent AI interactions
• Parallel Processing: Simultaneous tool execution for faster results

Quick Start

Interactive Session (Recommended)

python ask_reddit.py

The interactive session will:

1. Check your API keys (or help you enter them)
2. Ask what you'd like insights on
3. Analyze Reddit discussions with elegant dashboard
4. Show balanced insights with pros/cons
5. Offer to answer another query

Programmatic Usage

import asyncio
from reddit_consensus.recommender import AutonomousRedditConsensus

async def main():
    agent = AutonomousRedditConsensus()
    result = await agent.process_query("Best cafes in Adelaide Hills")
    agent.print_results()

asyncio.run(main())

Setup

1. Install Dependencies

uv sync

2. API Keys

You can either set environment variables or enter them when prompted:

Option A: Environment Variables (Recommended)

export OPENAI_API_KEY="your-openai-api-key"
export REDDIT_CLIENT_ID="your-reddit-client-id"
export REDDIT_CLIENT_SECRET="your-reddit-client-secret"
export REDDIT_USER_AGENT="YourApp/1.0 (by /u/yourusername)"

Option B: Enter When Prompted

Run python ask_reddit.py and the interactive session will help you enter credentials.

3. Get API Keys

• OpenAI: https://platform.openai.com/
• Reddit: https://www.reddit.com/prefs/apps/ (create "script" app)

Requirements

• Python 3.11+
• OpenAI API access
• Reddit API credentials