SETUP-GUIDE.md

🚀 DEEP.REBUILD Complete Setup Guide

📋 Required API Keys & Configuration

1. Supabase Database (Primary Storage)

• Where to get: supabase.com
• Steps:
  1. Create free account → New Project
  2. Go to Settings → API → Copy URL and Service Role Key
• Required Variables: ```env NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... ```

2. AI Providers (Choose at least one)

OpenAI (Recommended)

• Where to get: platform.openai.com/api-keys
• Cost: Pay-per-use (~$0.01-0.06 per 1K tokens)
• Models: GPT-4o, GPT-4o-mini, GPT-4-turbo
• Variable: ```env OPENAI_API_KEY=sk-proj-abc123... ```

OpenRouter (Multi-Model Access)

• Where to get: openrouter.ai/keys
• Cost: Varies by model ($0.002-0.10 per 1K tokens)
• Models: Claude, Llama, Gemini, GPT-4, and 200+ others
• Variable: ```env OPENROUTER_API_KEY=sk-or-v1-abc123... ```

Groq (Ultra-Fast Inference)

• Where to get: console.groq.com/keys
• Cost: Free tier available, then pay-per-use
• Models: Llama 3.1, Mixtral (500+ tokens/sec)
• Variable: ```env GROQ_API_KEY=gsk_abc123... ```

Grok (xAI)

• Where to get: console.x.ai
• Cost: Pay-per-use
• Models: Grok-beta, Grok-vision-beta
• Variable: ```env XAI_API_KEY=xai-abc123... ```

3. MongoDB (Optional Backup Storage)

• Where to get: mongodb.com/atlas
• Steps:
  1. Create free cluster (512MB)
  2. Database Access → Add User
  3. Network Access → Add IP (0.0.0.0/0 for development)
  4. Connect → Connect Application → Copy connection string
• Variable: ```env MONGODB_URI=mongodb+srv://username:password@cluster0.xxxxx.mongodb.net/deep_rebuild?retryWrites=true&w=majority ```

4. Deployment Tokens (For CI/CD)

Vercel

• Where to get: vercel.com/account/tokens
• Variable: ```env VERCEL_TOKEN=abc123... ```

HuggingFace

• Where to get: huggingface.co/settings/tokens
• Permissions: Write access to create/update Spaces
• Variables: ```env HF_TOKEN=hf_abc123... HF_SPACE_NAME=your-username/deep-rebuild ```

🔧 Quick Setup Commands

Local Development

```bash

1. Clone and install

git clone cd deep-rebuild npm install

2. Copy environment file

cp .env.example .env.local

3. Add your API keys to .env.local

4. Run development server

npm run dev ```

Deploy to Vercel

```bash

Option 1: One-click deploy

Click: https://vercel.com/new/clone?repository-url=

Option 2: Vercel CLI

npm i -g vercel vercel --prod ```

Deploy to HuggingFace

```bash

1. Create Space at huggingface.co/new-space

2. Choose Docker SDK

3. Push your code to the Space repository

4. Add environment variables in Space settings

```

🎯 Minimum Required Setup

For basic functionality, you only need:

1. Supabase (free tier) - Database
2. One AI Provider (OpenAI recommended) - AI Generation
3. Environment variables in your deployment platform

Optional enhancements:

• MongoDB for backup storage
• Multiple AI providers for redundancy
• Deployment tokens for automated CI/CD

🚨 Security Notes

• Never commit API keys to version control
• Use environment variables in production
• Rotate keys regularly
• Set usage limits on AI provider accounts
• Use service role keys for Supabase (not anon keys)

📊 Cost Estimates (Monthly)

• Supabase: Free (up to 500MB)
• MongoDB Atlas: Free (up to 512MB)
• OpenAI: $5-50 (depending on usage)
• Groq: $0-20 (generous free tier)
• Vercel: Free (hobby projects)
• HuggingFace: Free (public spaces)

Total estimated cost: $5-70/month depending on AI usage ```