Build and Deploy LangChain Retrieval Agent

CRITICAL: For Vercel, you MUST use vercel build --prod then vercel deploy --prebuilt --prod. Do NOT use vercel --prod or vercel deploy --prod directly - these will fail due to Git author permission issues in VM environments.

Workflow

1. Setup Environment Variables

Read .env.example to see all required variables:

bash
1cat .env.example

Create .env by reading values from current environment:

For each variable in .env.example, read the value from the current environment and write to .env. Example approach:

bash
1# Read .env.example and create .env with values from current environment
2while IFS= read -r line || [[ -n "$line" ]]; do
3  # Skip comments and empty lines
4  [[ "$line" =~ ^#.*$ || -z "$line" ]] && continue
5  # Extract variable name (before = sign)
6  var_name=$(echo "$line" | cut -d'=' -f1)
7  # Get value from environment
8  var_value="${!var_name}"
9  # Write to .env
10  echo "${var_name}=${var_value}" >> .env
11done < .env.example

Or manually inspect .env.example and create .env with the required values from environment variables.

2. Install Dependencies

bash
1yarn install

3. Setup Supabase Vector Store

Get the database connection URL from Supabase Dashboard:

• Go to Settings → Database → Connection string → URI
• Copy the URI and add it to .env as SUPABASE_DB_URL

bash
1yarn setup-db

This creates the pgvector extension, documents table, and match_documents function in your Supabase project.

4. Build

bash
1yarn build

5. Deploy

Vercel:

All vercel CLI commands require -t <token> or --token <token> for authentication.

bash
1# Pull project settings (also links project, creates .vercel/project.json)
2vercel pull --yes -t $VERCEL_TOKEN
3
4# Push env vars to Vercel (first time only)
5# Must add to each environment separately
6while IFS='=' read -r key value; do
7  [[ "$key" =~ ^#.*$ || -z "$key" || -z "$value" ]] && continue
8  for env in production preview development; do
9    printf '%s' "$value" | vercel env add "$key" $env -t $VERCEL_TOKEN
10  done
11done < .env
12
13# Build locally for production
14vercel build --prod -t $VERCEL_TOKEN
15
16# Deploy prebuilt
17vercel deploy --prebuilt --prod --yes -t $VERCEL_TOKEN

Netlify:

bash
1# Import all env vars from .env (first time only)
2netlify env:import .env
3
4# Deploy
5netlify deploy --prod

Critical Notes

• VERCEL PREBUILT MODE IS MANDATORY: Always use vercel build --prod followed by vercel deploy --prebuilt --prod. Never use vercel --prod or vercel deploy --prod without --prebuilt flag.
• Supabase Required: Need a Supabase project (free tier works)
• Vector Store Setup: Run yarn setup-db to create tables automatically
• Environment Variables: All values come from current environment - inspect .env.example for required variables
• OpenAI for Embeddings: OPENAI_API_KEY is always required for vector embeddings
• No Dev Server: Never run yarn dev in VM environment