Reddit

Query subreddit posts, stats, and trends with RedditTools using praw script-app credentials.

Prerequisites

1. Create or sign in to a Reddit account at reddit.com.
2. Create a script app at reddit.com/prefs/apps.
3. Copy the app’s client ID and client secret.

RedditTools can perform read-only operations with the client ID and client secret. Set a username and password only for write operations.

from agno.agent import Agent
from agno.tools.reddit import RedditTools

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------

agent = Agent(
    instructions=[
        "Use your tools to answer questions about Reddit content and statistics",
        "Respect Reddit's content policies and NSFW restrictions",
        "When analyzing subreddits, provide relevant statistics and trends",
    ],
    tools=[RedditTools()],
)

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    agent.print_response("What are the top 5 posts on r/SAAS this week ?", stream=True)

Run the Example

1. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   

   uv venv --python 3.12
   .venv\Scripts\activate
   
2. Install dependencies

   uv pip install -U agno openai praw
   
3. Export required credentials

   Mac/Linux

   export REDDIT_CLIENT_ID="your_reddit_client_id"
   export REDDIT_CLIENT_SECRET="your_reddit_client_secret"
   export OPENAI_API_KEY="your_openai_api_key_here"
   

   $Env:REDDIT_CLIENT_ID="your_reddit_client_id"
   $Env:REDDIT_CLIENT_SECRET="your_reddit_client_secret"
   $Env:OPENAI_API_KEY="your_openai_api_key_here"
   
4. Set optional Reddit credentials

   REDDIT_USER_AGENT overrides the default user agent. Set REDDIT_USERNAME and REDDIT_PASSWORD for write operations.

   Mac/Linux

   export REDDIT_USER_AGENT="platform:app_id:version (by /u/username)"
   export REDDIT_USERNAME="your_reddit_username"
   export REDDIT_PASSWORD="your_reddit_password"
   

   $Env:REDDIT_USER_AGENT="platform:app_id:version (by /u/username)"
   $Env:REDDIT_USERNAME="your_reddit_username"
   $Env:REDDIT_PASSWORD="your_reddit_password"
   
5. Run the example

   Save the code above as reddit_tools.py, then run:

   python reddit_tools.py
   

Full source: cookbook/91_tools/reddit_tools.py