Configuration
Configurez Astreus CLI avec des variables d'environnement pour une personnalisation complète. Ces paramètres contrôlent à la fois le CLI lui-même et les fonctionnalités sous-jacentes du framework Astreus que vous pouvez utiliser pendant le développement d'agents.
Configuration de l'environnement#
Créez un fichier .env dans votre répertoire personnel ou exportez des variables dans votre profil shell.
Configuration complète#
# ===== 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-gcmVariables requises#
Au minimum, vous avez besoin d'une clé API d'un fournisseur LLM :
# Choose one:
export OPENAI_API_KEY=sk-...
# or
export ANTHROPIC_API_KEY=...
# or
export GEMINI_API_KEY=...
# or just run Ollama locallyFournisseur et modèle par défaut#
Définissez vos préférences par défaut :
# Always start with Claude
export ASTREUS_PROVIDER=claude
export ASTREUS_MODEL=claude-sonnet-5
# Or start with local Ollama
export ASTREUS_PROVIDER=ollama
export ASTREUS_MODEL=llama3Configuration de la base de données#
SQLite (par défaut)#
Pour le développement local, SQLite fonctionne directement :
DB_URL=sqlite://./astreus.dbPostgreSQL (production)#
Pour la production ou les environnements partagés :
DB_URL=postgresql://user:password@localhost:5432/astreus_dbBase de données de connaissances#
Si vous utilisez les fonctionnalités RAG/Connaissances, vous avez besoin de PostgreSQL avec pgvector :
KNOWLEDGE_DB_URL=postgresql://user:password@localhost:5432/knowledge_dbParamètres de sécurité#
Chiffrement#
Activez le chiffrement pour les données sensibles :
ENCRYPTION_ENABLED=true
ENCRYPTION_MASTER_KEY=your-256-bit-key-here
ENCRYPTION_ALGORITHM=aes-256-gcmGénérez une clé sécurisée :
openssl rand -hex 32Journalisation#
Contrôlez la verbosité des logs :
# Options: debug | info | warn | error | silent
LOG_LEVEL=infoConfiguration du profil shell#
Ajoutez à votre ~/.bashrc, ~/.zshrc, ou ~/.profile :
# Astreus CLI Configuration
export OPENAI_API_KEY="sk-your-key"
export ASTREUS_PROVIDER="openai"
export ASTREUS_MODEL="gpt-4o"Puis rechargez :
source ~/.zshrc # or ~/.bashrcVérifier la configuration#
Vérifiez votre configuration :
# Start CLI and check settings
astreus
/settingsCela ouvre le panneau des paramètres montrant votre configuration actuelle.
Workflow de développement d'agents#
Pour la meilleure expérience de développement d'agents :
1. Configurer plusieurs fournisseurs#
Configurez plusieurs clés API pour pouvoir tester vos agents sur différents LLM :
# All providers configured
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export GEMINI_API_KEY="..."2. Utiliser les pièces jointes de projet#
Lorsque vous travaillez sur un projet d'agent, attachez le dossier pour un contexte complet :
astreus
/attach ./my-agent-projectLe CLI comprendra la structure de votre projet, le code existant et les configurations.
3. Itérer avec les sessions#
Vos sessions de développement sont automatiquement sauvegardées. Revenez pour continuer là où vous en étiez :
astreus
/sessions # See and restore previous sessions4. Tester différents modèles#
Une fois le code de votre agent généré, testez son comportement avec différents modèles sous-jacents :
/provider claude # Test with Claude
/provider openai # Test with GPT-4o
/provider ollama # Test locally