Configuration

Variables d'environnement et options de configuration pour votre projet d'agent Astreus.

Configuration de l'environnement#

Après avoir créé votre projet, copiez le fichier d'environnement exemple :

bash
cp .env.example .env

Puis éditez .env avec votre configuration.

Configuration spécifique au fournisseur#

Le fichier .env.example généré dépend du fournisseur que vous avez sélectionné :

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

Plusieurs fournisseurs#

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

Configuration complète#

Pour les déploiements en production, une configuration supplémentaire peut être nécessaire :

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

Configuration de la base de données#

SQLite (Développement)#

Par défaut et sans configuration pour le développement :

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

PostgreSQL (Production)#

Recommandé pour les déploiements en production :

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

Base de données de connaissances#

Requis pour les fonctionnalités RAG. Doit être PostgreSQL avec pgvector :

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

Configuration de pgvector#

Avec 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

Sécurité#

Clés de chiffrement#

Générez une clé de chiffrement sécurisée :

bash
openssl rand -hex 32

Ajoutez-la à votre environnement :

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

Checklist de production#

  • Utiliser PostgreSQL au lieu de SQLite
  • Activer le chiffrement
  • Définir NODE_ENV=production
  • Utiliser LOG_LEVEL=warn ou error
  • Stocker les secrets dans l'environnement, pas dans des fichiers
  • Utiliser un gestionnaire de secrets (Vault, AWS Secrets, etc.)

Modèles par défaut par fournisseur#

FournisseurModèle par défaut
OpenAIgpt-4o
Anthropicclaude-sonnet-5
Googlegemini-2.0-flash
Ollamallama3