ReviewMaster Deployment Package

Quick Start (Local Development)

# 1. Install dependencies
pip install -r requirements.txt

# 2. Set up environment
cp .env.template .env
# Edit .env with your OpenAI API key

# 3. Start the application
python backend/app.py

Open: http://localhost:8001

Digital Ocean Deployment

Upload and Deploy

# Upload this folder to your DO droplet, then:
sudo apt update && sudo apt upgrade -y
sudo apt install -y python3-pip python3-venv nginx

# Create app directory
sudo mkdir -p /var/www/reviewmaster
sudo cp -r * /var/www/reviewmaster/
cd /var/www/reviewmaster

# Set up Python environment
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Configure environment
cp .env.template .env
# Edit .env with your API keys

# Set up systemd service
sudo tee /etc/systemd/system/reviewmaster.service << EOF
[Unit]
Description=ReviewMaster API
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/var/www/reviewmaster
Environment="PATH=/var/www/reviewmaster/venv/bin"
ExecStart=/var/www/reviewmaster/venv/bin/python backend/app.py
Restart=always

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable reviewmaster
sudo systemctl start reviewmaster

# Set up nginx
sudo tee /etc/nginx/sites-available/reviewmaster << EOF
server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:8001;
        proxy_http_version 1.1;
        proxy_set_header Upgrade \$http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host \$host;
        proxy_cache_bypass \$http_upgrade;
        proxy_set_header X-Real-IP \$remote_addr;
        proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto \$scheme;
    }
}
EOF

sudo ln -s /etc/nginx/sites-available/reviewmaster /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

# Set up SSL (optional)
sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d your-domain.com

Features

Enhanced AI Personalization

• Uses reviewer names naturally
• References specific review details
• Platform-appropriate tone
• Emotional intelligence for different ratings
• Professional handling of complaints

Simple Authentication

• No API keys required for users
• Email/password signup
• Usage limits (3 free, 10 registered)

Production Ready

• JWT authentication
• Rate limiting
• Error handling
• Health checks

Configuration

Required Environment Variables

JWT_SECRET=your-jwt-secret-key
OPENAI_API_KEY=sk-your-openai-key
ADMIN_EMAIL=admin@yourdomain.com

Generate JWT Secret

openssl rand -hex 32

Usage Limits

User Type	Daily Limit
Anonymous	3 responses
Registered	10 responses
Pro	Unlimited (coming soon)

Troubleshooting

Common Issues

Port 8001 already in use

sudo lsof -i :8001
sudo kill -9 <PID>

Permission denied

sudo chown -R www-data:www-data /var/www/reviewmaster

OpenAI API errors

• Verify API key in .env file
• Check OpenAI account balance

Logs

# Application logs
sudo journalctl -u reviewmaster -f

# Nginx logs
sudo tail -f /var/log/nginx/error.log

Support

Your ReviewMaster deployment package includes:

• Enhanced personalization engine
• Simple auth system
• Beautiful responsive UI
• Production deployment scripts

Ready to transform generic review responses into genuine customer connections!