Prerequisites

Before setting up Earna AI Console, ensure you have all required dependencies and accounts configured.

System Requirements

Minimum Requirements

Operating System Support

• macOS: 12.0+ (Monterey or later)
• Windows: Windows 10/11 with WSL2
• Linux: Ubuntu 20.04+, Debian 11+, Fedora 35+

Required Accounts

Essential Services

1. Supabase Account (Free tier available)

   • Sign up at supabase.com 
   • Used for: Database, Auth, Storage, Realtime
   • Free tier includes:
     • 500MB database
     • 1GB storage
     • 50,000 monthly active users

2. OpenAI API Account (Required for GPT-4o)

   • Sign up at platform.openai.com 
   • Required for primary AI model
   • Pricing: ~$5-15 per million tokens
   • Models available: GPT-4o, GPT-4o-mini

3. Vercel Account (For deployment)

   • Sign up at vercel.com 
   • Free tier includes:
     • 100GB bandwidth
     • Serverless functions
     • Automatic HTTPS

Optional Services

Browser Requirements

Supported Browsers

Development Tools

Recommended IDE

Visual Studio Code with extensions:

• ESLint
• Prettier
• TypeScript and JavaScript
• Tailwind CSS IntelliSense
• Next.js snippets

Alternative IDEs

• WebStorm (full Next.js support)
• Cursor (AI-powered)
• Sublime Text
• Neovim with TypeScript LSP

Network Requirements

Ports

• 3000: Console development server
• 3002: Documentation server
• 3004: Credit Engine development server
• 3005: Apps development server
• 54321: Supabase local development (optional)

API Endpoints

Ensure your firewall allows connections to:

• api.openai.com (GPT-4o)
• *.supabase.co (Backend)
• api.anthropic.com (Claude, optional)
• generativelanguage.googleapis.com (Gemini, optional)

Pre-installation Checklist

Quick Verification Script

#!/bin/bash
# Save as check-prerequisites.sh
 
echo "Checking prerequisites for Earna AI Console..."
echo "============================================="
 
# Check Node.js
NODE_VERSION=$(node -v 2>/dev/null)
if [[ $NODE_VERSION == v22* ]] || [[ $NODE_VERSION == v23* ]]; then
    echo "✅ Node.js: $NODE_VERSION"
else
    echo "❌ Node.js 22+ required (found: $NODE_VERSION)"
fi
 
# Check pnpm
PNPM_VERSION=$(pnpm -v 2>/dev/null)
if [[ $PNPM_VERSION == 9* ]] || [[ $PNPM_VERSION == 10* ]]; then
    echo "✅ pnpm: $PNPM_VERSION"
else
    echo "❌ pnpm 9+ required (found: $PNPM_VERSION)"
fi
 
# Check Git
if command -v git &> /dev/null; then
    echo "✅ Git: $(git --version)"
else
    echo "❌ Git not found"
fi
 
# Check disk space
AVAILABLE_SPACE=$(df -h . | awk 'NR==2 {print $4}')
echo "📊 Available disk space: $AVAILABLE_SPACE"
 
# Check internet connectivity
if ping -c 1 api.openai.com &> /dev/null; then
    echo "✅ Internet connection verified"
else
    echo "⚠️  Cannot reach api.openai.com"
fi
 
echo "============================================="
echo "Setup guide: https://docs.earna.ai/get-started"

Next Steps

Once all prerequisites are met:

1. → Setup Guide - Install and configure the console
2. → Environment Variables - Configure API keys
3. → Architecture Overview - Understand the system

Troubleshooting Prerequisites

Common Issues

Node.js Version Too Old

# Install Node.js 22 using nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22

Permission Errors on pnpm install

# Fix pnpm permissions
pnpm config set store-dir ~/.pnpm-store
# Clear cache if needed
pnpm store prune
# Reinstall dependencies
pnpm install

Windows-specific Issues

• Enable WSL2 for better compatibility
• Use PowerShell or Git Bash, not Command Prompt
• Disable Windows Defender for node_modules folder

For more help, see Troubleshooting Guide.