Konfiguration

Konfiguriere Astreus CLI mit Umgebungsvariablen für vollständige Anpassung. Diese Einstellungen steuern sowohl die CLI selbst als auch die zugrunde liegenden Astreus-Framework-Funktionen, die du während der Agentenentwicklung verwenden kannst.

Einrichtung der Umgebung#

Erstelle eine .env-Datei in deinem Home-Verzeichnis oder exportiere Variablen in deinem Shell-Profil.

Vollständige Konfiguration#

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

Erforderliche Variablen#

Mindestens benötigst du einen API-Schlüssel für einen LLM-Provider:

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

Standard-Provider und -Modell#

Lege deine bevorzugten Standardeinstellungen fest:

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

Datenbankkonfiguration#

SQLite (Standard)#

Für die lokale Entwicklung funktioniert SQLite sofort:

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

PostgreSQL (Produktion)#

Für Produktions- oder gemeinsam genutzte Umgebungen:

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

Wissensdatenbank#

Wenn du RAG-/Wissensfunktionen verwendest, benötigst du PostgreSQL mit pgvector:

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

Sicherheitseinstellungen#

Verschlüsselung#

Aktiviere die Verschlüsselung für sensible Daten:

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

Generiere einen sicheren Schlüssel:

bash
openssl rand -hex 32

Logging#

Steuere die Ausführlichkeit der Protokollierung:

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

Einrichtung des Shell-Profils#

Füge Folgendes zu deiner ~/.bashrc, ~/.zshrc oder ~/.profile hinzu:

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

Lade dann neu:

bash
source ~/.zshrc  # or ~/.bashrc

Konfiguration überprüfen#

Überprüfe deine Konfiguration:

bash
# Start CLI and check settings
astreus
/settings

Dies öffnet das Einstellungsfenster mit deiner aktuellen Konfiguration.

Workflow für die Agentenentwicklung#

Für die beste Erfahrung bei der Agentenentwicklung:

1. Mehrere Provider einrichten#

Konfiguriere mehrere API-Schlüssel, damit du deine Agenten über verschiedene LLMs hinweg testen kannst:

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

2. Projektanhänge verwenden#

Wenn du an einem Agenten-Projekt arbeitest, hänge den Ordner an, um vollständigen Kontext zu erhalten:

bash
astreus
/attach ./my-agent-project

Die CLI wird deine Projektstruktur, den bestehenden Code und die Konfigurationen verstehen.

3. Mit Sitzungen iterieren#

Deine Entwicklungssitzungen werden automatisch gespeichert. Kehre zurück, um dort weiterzumachen, wo du aufgehört hast:

bash
astreus
/sessions  # See and restore previous sessions

4. Verschiedene Modelle testen#

Sobald dein Agentencode generiert ist, teste, wie er sich mit verschiedenen zugrunde liegenden Modellen verhält:

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