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...

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-gcm

Variables 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 locally

Fournisseur 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-4-20250514

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

Configuration de la base de données

SQLite (par défaut)

Pour le développement local, SQLite fonctionne directement :

DB_URL=sqlite://./astreus.db

PostgreSQL (production)

Pour la production ou les environnements partagés :

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

Base 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_db

Paramè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-gcm

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

openssl rand -hex 32

Journalisation

Contrôlez la verbosité des logs :

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

Configuration 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 ~/.bashrc

Vérifier la configuration

Vérifiez votre configuration :

# Start CLI and check settings
astreus
/settings

Cela 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-project

Le 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 sessions

4. 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

Dernière mise à jour : 6 juillet 2026

Dans cette section

Introduction

Assistant de développement alimenté par l'IA pour créer des agents avec le framework Astreus. Le CLI vous aide à créer, tester et itérer sur des agents IA...

Installation

Faites fonctionner Astreus CLI en quelques minutes. Le CLI est votre assistant alimenté par l'IA pour construire des agents avec le framework Astreus.

Commandes

Référence complète de toutes les commandes et raccourcis clavier d'Astreus CLI. Utilisez ces commandes pour gérer vos sessions de développement d'agents,...

Fournisseurs

Introduction