Configurazione

Configura Astreus CLI con variabili d'ambiente per una personalizzazione completa. Queste impostazioni controllano sia la CLI stessa sia le funzionalità del...

Configura Astreus CLI con variabili d'ambiente per una personalizzazione completa. Queste impostazioni controllano sia la CLI stessa sia le funzionalità del framework Astreus sottostante che puoi usare durante lo sviluppo degli agenti.

Configurazione dell'ambiente

Crea un file .env nella tua home directory oppure esporta le variabili nel profilo della tua shell.

Configurazione completa

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

Variabili richieste

Come minimo, ti serve la chiave API di un provider LLM:

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

Provider e modello predefiniti

Imposta le tue preferenze predefinite:

# 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

Configurazione del database

SQLite (predefinito)

Per lo sviluppo locale, SQLite funziona subito senza configurazioni aggiuntive:

DB_URL=sqlite://./astreus.db

PostgreSQL (produzione)

Per ambienti di produzione o condivisi:

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

Database della knowledge base

Se usi le funzionalità RAG/Knowledge, ti serve PostgreSQL con pgvector:

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

Impostazioni di sicurezza

Crittografia

Abilita la crittografia per i dati sensibili:

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

Genera una chiave sicura:

openssl rand -hex 32

Logging

Controlla il livello di verbosità dei log:

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

Configurazione del profilo della shell

Aggiungi al tuo ~/.bashrc, ~/.zshrc o ~/.profile:

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

Poi ricarica:

source ~/.zshrc  # or ~/.bashrc

Verifica la configurazione

Controlla la tua configurazione:

# Start CLI and check settings
astreus
/settings

Questo apre il pannello delle impostazioni che mostra la tua configurazione attuale.

Workflow di sviluppo degli agenti

Per la migliore esperienza di sviluppo degli agenti:

1. Configura più provider

Configura più chiavi API in modo da poter testare i tuoi agenti su diversi LLM:

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

2. Usa gli allegati di progetto

Quando lavori su un progetto di agente, allega la cartella per un contesto completo:

astreus
/attach ./my-agent-project

La CLI comprenderà la struttura del tuo progetto, il codice esistente e le configurazioni.

3. Itera con le sessioni

Le tue sessioni di sviluppo vengono salvate automaticamente. Torna per continuare da dove avevi interrotto:

astreus
/sessions  # See and restore previous sessions

4. Testa modelli diversi

Una volta generato il codice del tuo agente, testa come si comporta con diversi modelli sottostanti:

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

Ultimo aggiornamento: 6 luglio 2026

In questa sezione

Introduzione

Assistente di sviluppo basato su AI per costruire agenti con il framework Astreus. La CLI ti aiuta a creare, testare e iterare su agenti AI direttamente dal...

Installazione

Metti in funzione Astreus CLI in pochi minuti. La CLI è il tuo assistente basato su AI per costruire agenti con il framework Astreus.

Comandi

Riferimento completo per tutti i comandi e le scorciatoie da tastiera di Astreus CLI. Usa questi comandi per gestire le sessioni di sviluppo dei tuoi...

Provider

Introduzione