Configuration

Environment variables and configuration options for your Astreus agent project.

Environment Setup#

After creating your project, copy the example environment file:

bash

cp .env.example .env

Then edit .env with your configuration.

Provider-Specific Configuration#

The generated .env.example depends on your selected provider:

OpenAI#

bash

OPENAI_API_KEY=your-api-key-here

Anthropic#

bash

ANTHROPIC_API_KEY=your-api-key-here

Google Gemini#

bash

GEMINI_API_KEY=your-api-key-here

Ollama#

bash

# Ollama runs locally, no API key needed
OLLAMA_HOST=http://localhost:11434

Multiple Providers#

bash

# Add API keys for providers you want to use
OPENAI_API_KEY=your-openai-key
ANTHROPIC_API_KEY=your-anthropic-key
GEMINI_API_KEY=your-gemini-key

Complete Configuration#

For production deployments, you may need additional configuration:

bash

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

# OpenAI
OPENAI_API_KEY=sk-your-openai-api-key-here
OPENAI_VISION_API_KEY=sk-your-vision-api-key-here      # Optional
OPENAI_EMBEDDING_API_KEY=sk-your-embedding-api-key     # Optional

# Anthropic Claude
ANTHROPIC_API_KEY=your-anthropic-api-key-here
ANTHROPIC_VISION_API_KEY=your-vision-api-key-here      # Optional

# Google Gemini
GEMINI_API_KEY=your-gemini-api-key-here
GEMINI_VISION_API_KEY=your-vision-api-key-here         # Optional
GEMINI_EMBEDDING_API_KEY=your-embedding-api-key        # Optional

# Ollama (for local models)
OLLAMA_HOST=http://localhost:11434

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

# Main Application Database (Agents, Memory, Tasks, etc.)
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 required)
KNOWLEDGE_DB_URL=postgresql://username:password@localhost:5432/knowledge_db

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

NODE_ENV=development       # development | production | test
LOG_LEVEL=info             # debug | info | warn | error | silent

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

ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-256-bit-encryption-key-here
ENCRYPTION_ALGORITHM=aes-256-gcm

Database Configuration#

SQLite (Development)#

Default and zero-config for development:

bash

DB_URL=sqlite://./astreus.db

PostgreSQL (Production)#

Recommended for production deployments:

bash

DB_URL=postgresql://user:password@localhost:5432/astreus_db

Knowledge Database#

Required for RAG features. Must be PostgreSQL with pgvector:

bash

KNOWLEDGE_DB_URL=postgresql://user:password@localhost:5432/knowledge_db

Setting up pgvector#

Using Docker:

yaml

# docker-compose.yml
services:
  postgres:
    image: pgvector/pgvector:pg16
    environment:
      POSTGRES_USER: astreus
      POSTGRES_PASSWORD: password
      POSTGRES_DB: knowledge_db
    ports:
      - "5432:5432"

bash

docker-compose up -d

Security#

Encryption Keys#

Generate a secure encryption key:

bash

openssl rand -hex 32

Add to your environment:

bash

ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-generated-key
ENCRYPTION_ALGORITHM=aes-256-gcm

Production Checklist#

Use PostgreSQL instead of SQLite
Enable encryption
Set NODE_ENV=production
Use LOG_LEVEL=warn or error
Store secrets in environment, not files
Use a secrets manager (Vault, AWS Secrets, etc.)

Default Models by Provider#

Provider	Default Model
OpenAI	`gpt-4o`
Anthropic	`claude-sonnet-4-20250514`
Google	`gemini-2.0-flash`
Ollama	`llama3`