feat: Add configurable memory system with short-term and long-term storage

.env.example

@@ -0,0 +1,119 @@
+# ============================================
+# AIRI Stage Web - Environment Configuration
+# ============================================
+# This file contains all environment variables needed for deploying
+# AIRI Stage Web on Vercel or running it locally.
+# Copy this file to .env and fill in your actual values.
+
+# ============================================
+# Provider Health Checks
+# ============================================
+# Skip provider health checks to avoid CORS errors in serverless deployments.
+# Recommended: true for browser/Vercel environments
+VITE_SKIP_PROVIDER_HEALTH_CHECK=true
+
+# ============================================
+# Default Providers (REQUIRED)
+# ============================================
+# These must match configured provider identifiers
+DEFAULT_CHAT_PROVIDER=openai
+DEFAULT_SPEECH_PROVIDER=openai-audio-speech
+DEFAULT_TRANSCRIPTION_PROVIDER=openai-audio-transcription
+
+# ============================================
+# OpenAI Configuration
+# ============================================
+OPENAI_API_KEY=sk-...
+OPENAI_BASE_URL=https://api.openai.com/v1/
+OPENAI_MODEL=gpt-4o-mini
+
+# ============================================
+# OpenRouter Configuration
+# ============================================
+OPENROUTER_API_KEY=sk-or-...
+
+# ============================================
+# Anthropic Claude Configuration
+# ============================================
+ANTHROPIC_API_KEY=sk-ant-...
+
+# ============================================
+# Google Gemini Configuration
+# ============================================
+GOOGLE_GENERATIVE_AI_API_KEY=AIza...
+
+# ============================================
+# AIRI Backend WebSocket
+# ============================================
+# WebSocket endpoint for live configurator feature
+# Point to your AIRI backend for remote module configuration
+# Set VITE_DISABLE_WEBSOCKET=true to disable WebSocket in serverless deployments
+VITE_AIRI_WS_URL=wss://airi.yourdomain.com/ws
+VITE_DISABLE_WEBSOCKET=true
+
+# ============================================
+# Short-Term Memory Configuration (Vercel Serverless)
+# ============================================
+# Short-term memory stores conversation history via /api/memory/* serverless functions
+# Supports Vercel KV (recommended) or Upstash Redis
+
+# Option 1: Vercel KV (automatically provided when you create a KV database in Vercel Storage tab)
+KV_URL=https://*.kv.vercel-storage.com
+KV_REST_API_URL=https://*.kv.vercel-storage.com
+KV_REST_API_TOKEN=AX****
+KV_REST_API_READ_ONLY_TOKEN=AW****
+
+# Option 2: Upstash Redis (automatically provided when you create Upstash integration in Vercel)
+UPSTASH_KV_REST_API_URL=https://us1-bold-foo.upstash.io
+UPSTASH_KV_URL=https://us1-bold-foo.upstash.io
+UPSTASH_KV_REST_API_TOKEN=AX****
+UPSTASH_REDIS_URL=redis://default:****@us1-bold-foo.upstash.io:6379
+
+# Short-term memory settings
+SHORT_TERM_MEMORY_PROVIDER=vercel-kv
+MEMORY_NAMESPACE=memory
+SHORT_TERM_MEMORY_MAX_MESSAGES=20
+SHORT_TERM_MEMORY_TTL_SECONDS=1800
+
+# ============================================
+# Long-Term Memory Configuration (Optional)
+# ============================================
+# Long-term memory enables semantic search via vector databases
+# Supports Postgres+pgvector or Qdrant
+# Set to 'none' to disable long-term memory
+LONG_TERM_MEMORY_PROVIDER=postgres-pgvector
+MEMORY_LONG_TERM_PROVIDER=postgres-pgvector
+
+# ============================================
+# PostgreSQL + pgvector Configuration
+# ============================================
+# Required when LONG_TERM_MEMORY_PROVIDER=postgres-pgvector
+# Vercel Postgres URL is automatically provided when you create a Postgres database in Vercel Storage tab
+POSTGRES_URL=postgresql://user:pass@host/db
+DATABASE_URL=postgresql://user:pass@host/db
+MEMORY_TABLE_NAME=memory_embeddings
+
+# ============================================
+# Qdrant Configuration
+# ============================================
+# Required when LONG_TERM_MEMORY_PROVIDER=qdrant
+QDRANT_URL=https://xyz.cloud.qdrant.io
+QDRANT_API_KEY=your-api-key
+QDRANT_COLLECTION_NAME=memory
+
+# ============================================
+# Embedding Provider Configuration (Required for Long-Term Memory)
+# ============================================
+# Provider: openai or cloudflare
+EMBEDDING_PROVIDER=openai
+EMBEDDING_MODEL=text-embedding-3-small
+EMBEDDING_DIMENSIONS=1536
+
+# OpenAI Embedding Configuration
+OPENAI_API_KEY=sk-...
+OPENAI_BASE_URL=https://api.openai.com/v1/
+
+# Cloudflare Workers AI Configuration (alternative to OpenAI)
+CLOUDFLARE_ACCOUNT_ID=1234567890abcdef
+CLOUDFLARE_API_TOKEN=your-cf-token
+CLOUDFLARE_EMBEDDING_MODEL=@cf/baai/bge-base-en-v1.5

.gitignore

@@ -101,3 +101,7 @@ twitter-session.json
 result*
 
 
+
+# Coding helpers
+AGENTS.md
+CLAUDE.md

README.md

@@ -181,6 +181,10 @@ Please update the version in `Cargo.toml` after running `bumpp`:
 npx bumpp --no-commit --no-tag
 ```
 
+## Deployment to Vercel
+
+See [docs/content/en/docs/guides/deploy/vercel.md](docs/content/en/docs/guides/deploy/vercel.md) for the up-to-date deployment guide.
+
 ## Support of LLM API Providers (powered by [xsai](https://github.com/moeru-ai/xsai))
 
 - [x] [302.AI (sponsored)](https://share.302.ai/514k2v)