Reddit Radar is an AI assistant that keeps you informed about topics that matter to you across Reddit. It intelligently monitors your chosen subreddits, scanning top post content and comments, then distills this information into concise, actionable summaries. These insights are automatically delivered to your Slack workspace, helping you stay on top of relevant conversations without getting lost in the noise.

🚀 Quickstart

One option for publishing highlights from Reddit Radar is Slack. Follow the below instructions to set up the Slack webhook for a channel in your workspace. Set the Slack webhook along with other API keys after you clone the repository. Then, launch the assistant with the LangGraph server:

curl -LsSf https://astral.sh/uv/install.sh | sh
git clone https://github.com/langchain-ai/reddit_radar.git
cd reddit_radar
cp .env.example .env
uvx --refresh --from "langgraph-cli[inmem]" --with-editable . --python 3.11 langgraph dev

You should see the following output and Studio will open in your browser:

🚀 API: http://127.0.0.1:2024
🎨 Studio UI: https://smith.langchain.com/studio/?baseUrl=http://127.0.0.1:2024
📚 API Docs: http://127.0.0.1:2024/docs

Pass any topics of interest as a string:

In the configuration tab, configure various parameters:

Slack posts:

Motivation

Reddit Radar is an AI agent that helps you stay informed about specific topics across Reddit's vast ecosystem. While Reddit organizes discussions into subreddits, the volume of posts and comments can be overwhelming. This tool automatically monitors your chosen subreddits, analyzes discussions for topics you care about, and delivers relevant insights through your preferred channel (Slack, email, etc.). It's like having a personal assistant that reads Reddit for you, focusing only on what matters to you.

Setup Details

Reddit API

Get credentials for Reddit API:

Go to Reddit's App Preferences
Click "Create Application" or "Create Another Application"
Fill in the following:
- Name: reddit-radar (or any name you prefer)
- Select "script" as the application type
- Description: Optional, but helpful for remembering the app's purpose
- About URL: Can be left blank for personal use
- Redirect URI: Use http://localhost:8080
Click "Create app"
Once created, you'll see your credentials:
- Client ID: Found under your app name
- Client Secret: Listed as "secret"

Add the following credentials to your environment:

REDDIT_CLIENT_ID
REDDIT_CLIENT_SECRET

Publishing to Slack

Since ambient newfeed agents like Reddit Radar work best when integrated into existing workflows, we publish takes insights directly to Slack. To set up a webhook to publish to Slack:

Go to https://api.slack.com/apps
Click "Create New App"
Choose "From scratch"
Name your app (e.g., "Reddit Radar") and select your workspace
Once created, go to "Incoming Webhooks" in the left sidebar
Toggle "Activate Incoming Webhooks" to On
Click "Add New Webhook to Workspace"
Choose the channel where you want the messages to appear
Copy the "Webhook URL" that's generated

Add add webhook URL credentials to your environment variable SLACK_WEBHOOK.

Hosted Deployment

Optionally, deploy your app to LangGraph Cloud, a managed service for running LangGraph graphs.

This makes it easy to set up a scheduled job to run the graph on a regular basis (e.g., daily) and publish the results to Slack.

You can use the LangGraph Python SDK to create a scheduled job:

from langgraph_sdk import get_client

# URL from our LangGraph Cloud deployment
deployed_url = "app-deployment-url"
client = get_client(url=deployed_url)

# An assistant ID is automatically created for each deployment
await client.assistants.search(metadata={"created_by": "system"})

# Set the assistant ID you want to create a cron job for
assistant_id = 'xxx'

# Use she SDK to schedule a cron job e.g., to run at 1:00 PM PST (21:00 UTC) every day
cron_job_stateless = await client.crons.create(
    assistant_id,
    schedule="0 21 * * *",
    input={"user_provided_topics": ""} 
)

In this case, topics can be passed via user_provided_topics or added to the configuration.