Quick Start Guide

Get RedHarmony running in minutes.

Prerequisites

• Python 3.8+
• Reddit account with API access
• OpenAI API key with GPT-4 access

5-Minute Setup

1. Clone and Install

git clone https://github.com/jeffersonnnn/redharmony.git
cd redharmony
python3 -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows
pip install -r requirements.txt

2. Configure Environment

cp .env.example .env

Edit .env with your credentials:

OPENAI_API_KEY="your_openai_api_key"
REDDIT_USERNAME="your_username"
REDDIT_PASSWORD="your_password"
REDDIT_CLIENT_ID="your_client_id"
REDDIT_CLIENT_SECRET="your_client_secret"

3. Create Your First Persona

// accounts.json
[
    {
        "subreddits": ["python", "learnpython"],
        "prompt": "You are a helpful Python developer who enjoys explaining concepts clearly..."
    }
]

4. Run RedHarmony

python main.py

What's Next?

• Read Core Concepts to understand how RedHarmony works
• Check Configuration for detailed setup options
• Follow Tutorials for common use cases