Configuración

Variables de entorno y opciones de configuración para tu proyecto de agente de Astreus.

Configuración del entorno#

Después de crear tu proyecto, copia el archivo de entorno de ejemplo:

bash
cp .env.example .env

Luego edita .env con tu configuración.

Configuración específica por proveedor#

El .env.example generado depende del proveedor que hayas seleccionado:

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

Múltiples proveedores#

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

Configuración completa#

Para despliegues en producción, es posible que necesites configuración adicional:

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

Configuración de la base de datos#

SQLite (desarrollo)#

Predeterminado y sin configuración para desarrollo:

bash
DB_URL=sqlite://./astreus.db

PostgreSQL (producción)#

Recomendado para despliegues en producción:

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

Base de datos de conocimiento#

Necesaria para las funciones de RAG. Debe ser PostgreSQL con pgvector:

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

Configuración de pgvector#

Usando 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

Seguridad#

Claves de cifrado#

Genera una clave de cifrado segura:

bash
openssl rand -hex 32

Añádela a tu entorno:

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

Lista de verificación para producción#

  • Usar PostgreSQL en lugar de SQLite
  • Habilitar el cifrado
  • Establecer NODE_ENV=production
  • Usar LOG_LEVEL=warn o error
  • Guardar los secretos en el entorno, no en archivos
  • Usar un gestor de secretos (Vault, AWS Secrets, etc.)

Modelos predeterminados por proveedor#

ProveedorModelo predeterminado
OpenAIgpt-4o
Anthropicclaude-sonnet-5
Googlegemini-2.0-flash
Ollamallama3