# Environment
URL: /docs/framework/env-example
Source: /app/src/content/docs/framework/env-example.mdx

import { DocImage } from '@/components/DocImage';

<DocImage title="Environment" />

**Environment configuration for Astreus AI applications**

## Complete Configuration

```bash
# ===========================================
# Astreus AI - Environment Variables Example
# ===========================================

# ===== DATABASE CONFIGURATION =====

# Main Application Database (Agents, Memory, Tasks, etc.)
# SQLite (default for development)
DB_URL=sqlite://./astreus.db

# PostgreSQL (production recommended)
# DB_URL=postgresql://username:password@localhost:5432/astreus_db

# ===== KNOWLEDGE/RAG SYSTEM =====

# Knowledge Vector Database (PostgreSQL with pgvector extension required)
# This is separate from the main database and stores vector embeddings
KNOWLEDGE_DB_URL=postgresql://username:password@localhost:5432/knowledge_db

# ===== LLM PROVIDERS API KEYS =====

# OpenAI
OPENAI_API_KEY=sk-your-openai-api-key-here                    # Primary key (fallback for vision/embedding)
OPENAI_VISION_API_KEY=sk-your-vision-api-key-here            # Optional dedicated vision key
OPENAI_EMBEDDING_API_KEY=sk-your-embedding-api-key-here      # Optional dedicated embedding key
OPENAI_BASE_URL=https://api.openai.com/v1                    # Primary base URL (fallback for vision/embedding)
OPENAI_VISION_BASE_URL=https://api.openai.com/v1             # Optional dedicated vision base URL
OPENAI_EMBEDDING_BASE_URL=https://api.openai.com/v1          # Optional dedicated embedding base URL

# Anthropic Claude
ANTHROPIC_API_KEY=your-anthropic-api-key-here                # Primary key (fallback for vision)
ANTHROPIC_VISION_API_KEY=your-vision-api-key-here            # Optional dedicated vision key
ANTHROPIC_BASE_URL=https://api.anthropic.com                 # Primary base URL (fallback for vision)
ANTHROPIC_VISION_BASE_URL=https://api.anthropic.com          # Optional dedicated vision base URL

# Google Gemini
GEMINI_API_KEY=your-gemini-api-key-here                      # Primary key (replaces GOOGLE_API_KEY)
GEMINI_VISION_API_KEY=your-vision-api-key-here               # Optional dedicated vision key  
GEMINI_EMBEDDING_API_KEY=your-embedding-api-key-here         # Optional dedicated embedding key
GEMINI_BASE_URL=https://generativelanguage.googleapis.com    # Primary base URL (fallback for vision/embedding)
GEMINI_VISION_BASE_URL=https://generativelanguage.googleapis.com # Optional dedicated vision base URL
GEMINI_EMBEDDING_BASE_URL=https://generativelanguage.googleapis.com # Optional dedicated embedding base URL

# Ollama (for local models)
OLLAMA_BASE_URL=http://localhost:11434                       # Same as before

# ===== APPLICATION SETTINGS =====

# Environment
NODE_ENV=development  # Options: 'development' | 'production' | 'test'

# ===== DATABASE ENCRYPTION =====

# Enable/disable field-level encryption for sensitive data
ENCRYPTION_ENABLED=true  # Options: 'true' | 'false'

# Master encryption key (required when ENCRYPTION_ENABLED=true)
# IMPORTANT: Generate a strong 32+ character key and keep it secure!
# You can generate one with: openssl rand -hex 32
ENCRYPTION_MASTER_KEY=your-256-bit-encryption-key-here-keep-it-safe-and-secure

# Encryption algorithm (default: aes-256-gcm)
ENCRYPTION_ALGORITHM=aes-256-gcm
```