Konfiguration

Konfiguriere Astreus CLI mit Umgebungsvariablen für vollständige Anpassung. Diese Einstellungen steuern sowohl die CLI selbst als auch die zugrunde...

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

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

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

# 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

Datenbankkonfiguration

SQLite (Standard)

Für die lokale Entwicklung funktioniert SQLite sofort:

DB_URL=sqlite://./astreus.db

PostgreSQL (Produktion)

Für Produktions- oder gemeinsam genutzte Umgebungen:

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

Wissensdatenbank

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

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

Sicherheitseinstellungen

Verschlüsselung

Aktiviere die Verschlüsselung für sensible Daten:

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

Generiere einen sicheren Schlüssel:

openssl rand -hex 32

Logging

Steuere die Ausführlichkeit der Protokollierung:

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

Einrichtung des Shell-Profils

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

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

Lade dann neu:

source ~/.zshrc  # or ~/.bashrc

Konfiguration überprüfen

Überprüfe deine Konfiguration:

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

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

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:

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:

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

Zuletzt aktualisiert: 6. Juli 2026

In diesem Abschnitt

Einführung

KI-gestützter Entwicklungsassistent zum Erstellen von Agenten mit dem Astreus-Framework. Die CLI hilft dir dabei, KI-Agenten direkt von deinem Terminal aus...

Installation

Bringe Astreus CLI in wenigen Minuten zum Laufen. Die CLI ist dein KI-gestützter Assistent zum Erstellen von Agenten mit dem Astreus-Framework.

Befehle

Vollständige Referenz für alle Astreus CLI-Befehle und Tastenkombinationen. Verwende diese Befehle, um deine Agenten-Entwicklungssitzungen zu verwalten,...