Installation

# Clone the repository
git clone https://github.com/jeffgreendesign/textrawl.git
cd textrawl
 
# Install dependencies
pnpm install
 
# Run interactive setup
pnpm run setup
 
# Start development server
pnpm run dev

# Clone the repository
git clone https://github.com/jeffgreendesign/textrawl.git
cd textrawl
 
# Create .env file
cp .env.example .env
# Edit .env with your credentials
 
# Build and run
docker compose up -d

# Start PostgreSQL + pgvector
docker compose -f docker-compose.local.yml up -d
 
# Optionally start Ollama for local embeddings
docker compose -f docker-compose.local.yml --profile ollama up -d
 
# Optionally start pgAdmin for database management
docker compose -f docker-compose.local.yml --profile admin up -d

-- For OpenAI embeddings (1536 dimensions)
-- Copy contents of scripts/setup-db.sql
 
-- For Ollama embeddings (1024 dimensions)
-- Copy contents of scripts/setup-db-ollama.sql

-- Copy contents of scripts/security-rls.sql

# Using docker-compose.local.yml
docker compose -f docker-compose.local.yml up -d
 
# Connect to database
psql postgresql://textrawl:textrawl@localhost:5432/textrawl
 
# Enable pgvector
CREATE EXTENSION IF NOT EXISTS vector;
 
# Run setup SQL files
\i scripts/setup-db.sql
\i scripts/security-rls.sql

cp .env.example .env

# Supabase connection
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
 
# OpenAI for embeddings
OPENAI_API_KEY=sk-...

# Server configuration
PORT=3000
LOG_LEVEL=info
 
# Authentication (required for production)
API_BEARER_TOKEN=your-secure-token-min-32-chars
 
# CORS (comma-separated origins)
ALLOWED_ORIGINS=http://localhost:3000
 
# Alternative: Use Ollama instead of OpenAI
EMBEDDING_PROVIDER=ollama
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=nomic-embed-text

# Check health endpoint
curl http://localhost:3000/health
 
# Expected response:
# {"status":"ok","timestamp":"2025-01-01T00:00:00.000Z"}
 
# Check readiness (includes database)
curl http://localhost:3000/health/ready
 
# Test MCP Inspector
pnpm run inspector