external-services-setup.md

Context Store - External Services Setup

Required External Services

To deploy Context Store without local dependencies, set up these cloud services:

1. PostgreSQL Database

Recommended: Neon (Free tier available)

1. Go to https://neon.tech
2. Create account and new project
3. Copy connection string
4. Set DATABASE_URL and DIRECT_URL to the same value

Alternative: Supabase

1. Go to https://supabase.com
2. Create project
3. Get connection string from Settings > Database

2. Neo4j Knowledge Graph

Neo4j Aura (Free tier available)

1. Go to https://neo4j.com/cloud/aura/
2. Create free account
3. Create database instance
4. Copy connection URI, username, password
5. Set NEO4J_URI, NEO4J_USERNAME, NEO4J_PASSWORD

3. Redis Cache

Recommended: Upstash Redis (Free tier available)

1. Go to https://upstash.com
2. Create Redis database
3. Copy connection details
4. Set REDIS_HOST, REDIS_PORT, REDIS_PASSWORD

Alternative: Redis Cloud

1. Go to https://redis.com/redis-enterprise-cloud/
2. Create database
3. Get connection details

4. Environment Variables

Create .env file with these values:

# PostgreSQL (from Neon/Supabase)
DATABASE_URL=postgresql://username:password@hostname:port/database
DIRECT_URL=postgresql://username:password@hostname:port/database

# Neo4j (from Aura)
NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=your-password

# Redis (from Upstash)
REDIS_HOST=your-redis.upstash.io
REDIS_PORT=6379
REDIS_PASSWORD=your-password

# Required APIs
OPENAI_API_KEY=sk-your-key
TRIGGER_PROJECT_ID=proj_gtuachiolvvekkzclssn
TRIGGER_SECRET_KEY=tr_dev_your-key

# App Security
SESSION_SECRET=your-long-random-string-at-least-32-chars
ENCRYPTION_KEY=your-32-character-encryption-key-here

# HuggingFace Deployment
PORT=7860
NODE_ENV=production
HOST=0.0.0.0

5. Quick Setup Commands

After setting up external services:

# Deploy to HuggingFace
git add .
git commit -m "External services configuration"
git push origin main

# Create HuggingFace Space
# 1. Go to https://huggingface.co/spaces
# 2. Click "Create new Space"
# 3. Choose Docker SDK
# 4. Connect your GitHub repo
# 5. Add environment variables in Space settings

Service Costs (Free Tiers)

• Neon PostgreSQL: 500MB storage free
• Neo4j Aura: 200k nodes + 400k relationships free
• Upstash Redis: 10k commands/day free
• HuggingFace Spaces: Free for public spaces
• Trigger.dev: 1000 runs/month free

Total: $0/month for development usage