Spaces:
Running
Running
| # Setup Guide | |
| Complete step-by-step guide to get the system running. | |
| ## Prerequisites | |
| - **Node.js** 18+ (recommended: 20 LTS) | |
| - **Python** 3.11+ | |
| - **npm** 9+ | |
| - **Git** | |
| ## Step 1: API Keys | |
| Create accounts and get keys from these services (all FREE): | |
| ### 1.1 NVIDIA NIM (LLM — MiniMax + LLaMA) | |
| 1. Go to https://build.nvidia.com | |
| 2. Sign up / login | |
| 3. Click any model → "Get API Key" | |
| 4. Copy key (starts with `nvapi-`) | |
| 5. Free: 1000+ requests/day | |
| ### 1.2 Serper.dev (Google Search) | |
| 1. Go to https://serper.dev | |
| 2. Sign up with Google | |
| 3. Dashboard → copy API key | |
| 4. Free: 2,500 searches/month | |
| ### 1.3 Hunter.io (Email Finding) | |
| 1. Go to https://hunter.io | |
| 2. Sign up → Dashboard → API | |
| 3. Copy API key | |
| 4. Free: 25 searches/month | |
| ### 1.4 Reoon (Email Verification) | |
| 1. Go to https://emailverifier.reoon.com | |
| 2. Sign up → Dashboard → API | |
| 3. Copy API key | |
| 4. Free: 20 verifications/day | |
| 5. NOTE: System optimizes usage (SMTP probe first, Reoon fallback) | |
| ### 1.5 Supabase (Database) | |
| 1. Go to https://supabase.com | |
| 2. Create project | |
| 3. Project Settings → API | |
| 4. Copy **Project URL** and **service_role key** (not anon key!) | |
| 5. Free: 500MB database | |
| ### 1.6 Slack Bot | |
| 1. Go to https://api.slack.com/apps → Create New App | |
| 2. Name: "Lead Finder" | |
| 3. OAuth & Permissions → Add scopes: `chat:write`, `commands`, `channels:read` | |
| 4. Install to Workspace → copy Bot Token (`xoxb-...`) | |
| 5. Basic Information → copy Signing Secret | |
| 6. Create 2 channels: `#leads` and `#review` | |
| 7. Get channel IDs: right-click channel → View details → copy ID | |
| ### 1.7 Trigger.dev (Job Orchestration) | |
| 1. Go to https://trigger.dev → Sign up | |
| 2. Create project | |
| 3. Dashboard → API Keys → copy | |
| 4. Project ID from URL: `trigger.dev/orgs/.../projects/[PROJECT_ID]` | |
| 5. Free: 50,000 runs/month | |
| ## Step 2: Environment Setup | |
| ```bash | |
| cp .env.example .env | |
| ``` | |
| Edit `.env` and fill in all keys from Step 1. | |
| ## Step 3: Database Migration | |
| Option A — Supabase Dashboard: | |
| 1. Open Supabase → SQL Editor | |
| 2. Paste contents of `supabase/migrations/001_initial_schema.sql` → Run | |
| 3. Paste contents of `supabase/migrations/002_phase1_enhancements.sql` → Run | |
| Option B — Supabase CLI: | |
| ```bash | |
| npx supabase migration up | |
| ``` | |
| ## Step 4: Install & Run | |
| ```bash | |
| # Install Node.js dependencies | |
| npm install | |
| # Install Python dependencies | |
| cd src/profiling/python-service | |
| pip install -r requirements.txt | |
| cd ../../.. | |
| # Terminal 1: Start Trigger.dev | |
| npm run trigger:dev | |
| # Terminal 2: Start Python AI service | |
| cd src/profiling/python-service | |
| python main.py | |
| ``` | |
| ## Step 5: Verify | |
| The system runs automatically at 9 AM PKT daily. To test manually: | |
| - Use Slack `/discover` command | |
| - Or trigger from Trigger.dev dashboard | |
| ## Troubleshooting | |
| | Issue | Solution | | |
| |-------|---------| | |
| | `NVIDIA_API_KEY` error | Check key starts with `nvapi-` | | |
| | MiniMax 429 rate limit | System auto-retries after wait | | |
| | Hunter returns empty | Free tier: 25/month limit reached | | |
| | SMTP verification fails | Some mail servers block port 25 | | |
| | Supabase connection error | Check `SUPABASE_URL` has `https://` | | |