🧠 Reddit Persona Generator

Generate detailed, structured, and visual personas of Reddit users using their public activity. This project uses Reddit's API for scraping and Cohere's LLMs to generate human-like persona descriptions — perfect for marketing research, UX personas, or social analysis.

---

🔍 What It Does

1. Takes a Reddit profile URL as input (e.g. https://www.reddit.com/user/SuperbPercentage8050/)
2. Scrapes recent posts and comments using praw
3. Sends this data to Cohere’s LLM to generate a structured user persona
4. Saves the persona in a clean .txt file
5. Optionally converts the persona into a polished image format (PNG)

---

📁 Project Structure

reddit-persona/
├── data/                    # JSON scraped data from Reddit
├── output/                  # Generated persona .txt and .png files

├── main.py                  # Main CLI script (single-command execution)
├── reddit_scraper.py        # Reddit data scraper using PRAW
├── persona_generator.py     # Persona generator using Cohere API
├── visual_generator.py      # Converts persona .txt into styled PNG

├── .env                     # Contains API keys (excluded from version control)
├── requirements.txt         # Python dependencies
├── Arial.ttf                # Arial font file
└── README.md                # Project documentation

---

⚙️ Installation & Setup

1. Clone the repository

git clone https://github.com/IshaanPathak25/ReddiScope.git
cd ReddiScope

2. Create a virtual environment (recommended but not mandatory)

python -m venv .venv
source .venv/bin/activate   # On Windows: .venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

---

🔐 Setting Up API Keys

To run this project, you'll need API credentials for both Reddit and Cohere. Here's how to get them:

🛠️ 1. Get Your Reddit API Credentials

1. Visit https://www.reddit.com/prefs/apps while logged into your Reddit account.
2. Scroll to the bottom and click "Create App" or "Create Another App".
3. Fill in the following fields:
   • Name: Anything (e.g., RedditPersonaApp)
   • App type: Select "script"
   • Redirect URI: Enter http://localhost
   • Description: Optional
4. After creation, you'll see:
   • Client ID (under the app name)
   • Client Secret (shown below the redirect URI)

Save these for use in your .env file:

REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_client_secret
REDDIT_USER_AGENT=your_custom_user_agent

🧠 2. Get Your Cohere API Key

1. Go to https://dashboard.cohere.com/api-keys
2. Sign up or log in, then copy your default API Key
3. Add it to your .env file:

COHERE_API_KEY=your_cohere_api_key

Once your .env is properly configured, the app will be able to:

• Scrape Reddit user data using PRAW
• Generate detailed personas using Cohere’s command-r-plus model

---

🚀 How to Use

python main.py

Example

👋 Welcome to Reddit Persona Generator!
🔗 Enter Reddit profile URL: https://www.reddit.com/user/SuperbPercentage8050/
...
✅ Persona saved to: output/SuperbPercentage8050_persona.txt
✅ Visual persona saved as: output/SuperbPercentage8050_persona.png

---

🧠 Example Persona Output

👋 Welcome to Reddit Persona Generator!
🔗 Enter Reddit profile URL: https://www.reddit.com/user/SuperbPercentage8050/
...
✅ Persona saved to: output/SuperbPercentage8050_persona.txt
✅ Visual persona saved as: output/SuperbPercentage8050_persona.png

---

📦 Dependencies

• cohere – Used to generate personas using the Cohere LLM API.
• praw – For scraping Reddit user data (posts and comments).
• tqdm – Adds progress bars while fetching data from Reddit.
• python-dotenv – Loads API keys and secrets from a .env file.
• Pillow – Creates clean, styled PNG visual personas from text files.

Install via:

pip install -r requirements.txt

---

💡 Future Plans

• 🖥️ Build a GUI version (Tkinter / Streamlit / Gradio)
• 📄 Export persona as PDF
• 🌐 Deploy web version on Hugging Face Spaces

---

🧪 Tech Stack

• Reddit API (via PRAW)
  Used to scrape user posts and comments from Reddit in a structured format using Python Reddit API Wrapper (PRAW).

• Cohere LLMs
  Generates structured and insightful personas using Cohere's command-r-plus language model API.

• Pillow
  Python Imaging Library (PIL fork) used to create visual representations of user personas as dynamically generated PNGs.

• Python 3.9+
  The core programming language used for all scraping, processing, and persona generation tasks.

---

📜 License

This project is licensed under the MIT License. Feel free to fork, modify, and build upon it. Just give credit. 🙌

---

✨ Author

Ishaan Pathak

• 🔗 GitHub | 💼 LinkedIn