Configuración

Configura Astreus CLI con variables de entorno para una personalización total. Estos ajustes controlan tanto la propia CLI como las funciones subyacentes...

Configura Astreus CLI con variables de entorno para una personalización total. Estos ajustes controlan tanto la propia CLI como las funciones subyacentes del framework Astreus que puedes usar durante el desarrollo de agentes.

Configuración del entorno

Crea un archivo .env en tu directorio personal o exporta las variables en el perfil de tu shell.

Configuración completa

# ===== CLI SETTINGS =====

# Default provider and model
ASTREUS_PROVIDER=openai    # openai, claude, gemini, ollama
ASTREUS_MODEL=gpt-4o       # Default model name

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

Variables obligatorias

Como mínimo, necesitas una clave de API de un proveedor de LLM:

# Choose one:
export OPENAI_API_KEY=sk-...
# or
export ANTHROPIC_API_KEY=...
# or
export GEMINI_API_KEY=...
# or just run Ollama locally

Proveedor y modelo predeterminados

Configura tus valores preferidos:

# Always start with Claude
export ASTREUS_PROVIDER=claude
export ASTREUS_MODEL=claude-sonnet-4-20250514

# Or start with local Ollama
export ASTREUS_PROVIDER=ollama
export ASTREUS_MODEL=llama3

Configuración de la base de datos

SQLite (predeterminado)

Para el desarrollo local, SQLite funciona sin configuración adicional:

DB_URL=sqlite://./astreus.db

PostgreSQL (producción)

Para producción o entornos compartidos:

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

Base de datos de conocimiento

Si usas las funciones de RAG/conocimiento, necesitas PostgreSQL con pgvector:

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

Ajustes de seguridad

Cifrado

Activa el cifrado para datos sensibles:

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

Genera una clave segura:

openssl rand -hex 32

Registro (logging)

Controla la verbosidad de los logs:

# Options: debug | info | warn | error | silent
LOG_LEVEL=info

Configuración del perfil de shell

Añade esto a tu ~/.bashrc, ~/.zshrc o ~/.profile:

# Astreus CLI Configuration
export OPENAI_API_KEY="sk-your-key"
export ASTREUS_PROVIDER="openai"
export ASTREUS_MODEL="gpt-4o"

Luego recarga:

source ~/.zshrc  # or ~/.bashrc

Verificar la configuración

Comprueba tu configuración:

# Start CLI and check settings
astreus
/settings

Esto abre el panel de ajustes, que muestra tu configuración actual.

Flujo de trabajo para el desarrollo de agentes

Para la mejor experiencia de desarrollo de agentes:

1. Configura varios proveedores

Configura varias claves de API para poder probar tus agentes en distintos LLM:

# All providers configured
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="..."

2. Usa adjuntos de proyecto

Cuando trabajes en un proyecto de agente, adjunta la carpeta para tener contexto completo:

astreus
/attach ./my-agent-project

La CLI entenderá la estructura de tu proyecto, el código existente y las configuraciones.

3. Itera con sesiones

Tus sesiones de desarrollo se guardan automáticamente. Vuelve para continuar donde lo dejaste:

astreus
/sessions  # See and restore previous sessions

4. Prueba distintos modelos

Una vez generado el código de tu agente, comprueba cómo se comporta con distintos modelos subyacentes:

/provider claude   # Test with Claude
/provider openai   # Test with GPT-4o
/provider ollama   # Test locally

Última actualización: 6 de julio de 2026

En esta sección

Introducción

Asistente de desarrollo con IA para crear agentes con el framework Astreus. La CLI te ayuda a crear, probar e iterar sobre agentes de IA directamente desde...

Instalación

Pon en marcha Astreus CLI en minutos. La CLI es tu asistente de IA para construir agentes con el framework Astreus.

Comandos

Referencia completa de todos los comandos de Astreus CLI y sus atajos de teclado. Usa estos comandos para gestionar tus sesiones de desarrollo de agentes,...

Proveedores

Introducción