Astreus

Environment

Environment configuration for Astreus AI applications Learn the setup patterns, APIs, and practical examples needed to build reliable Astreus agent systems.

Environment configuration for Astreus AI applications

Complete Configuration

# ===========================================
# 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

Last updated: May 26, 2026