Personal Reddit Reader is a small, non-commercial Python example for reading public Reddit posts through the official Reddit Data API with OAuth.

The project is intended for private reading, archiving, and personal analysis of selected public subreddits. It is read-only and does not post, comment, vote, send messages, follow users, moderate communities, redistribute data, sell data, profile users, or train AI/ML models.

• Read public submissions from a small set of selected subreddits.
• Store basic public fields locally for private use, such as title, body text, URL, permalink, creation time, score, and comment count.
• Stay within Reddit's free API rate limit.
• Use a clear, unique User-Agent.
• Keep credentials outside source control.

• Commercial monitoring, advertising, lead generation, or resale.
• Bulk redistribution of Reddit data.
• User profiling or sensitive inference.
• AI/ML model training.
• Circumventing Reddit access controls, rate limits, or deleted-content behavior.

1. Create a Reddit OAuth app for personal use.
2. Install dependencies:

pip install -r requirements.txt

3. Copy the environment example and fill in your own values:

cp .env.example .env

4. Run the example:

python examples/fetch_posts.py python --limit 10

The example reads credentials from environment variables:

• REDDIT_CLIENT_ID
• REDDIT_CLIENT_SECRET
• REDDIT_USER_AGENT

Example User-Agent format:

windows:personal-reddit-reader:v0.1 (by /u/your_username)

The example prints selected public fields to standard output. If local storage is added later, stored data should remain private, limited in scope, and removable when Reddit content is deleted or when Reddit policy requires removal.