Provider

Astreus CLI supporta più provider LLM. Passa da uno all'altro senza interruzioni per testare i tuoi agenti con modelli diversi e trovare il migliore per il tuo caso d'uso.

Provider supportati

Gli esempi selezionano i modelli esplicitamente; i valori predefiniti ancora supportati non cambiano. I modelli ritirati dalle API native richiedono la selezione esplicita di un modello attuale in sostituzione.

La CLI esistente ottiene le opzioni dei modelli dal framework installato tramite getModelsByProvider. Le quattro opzioni restano openai, claude, gemini e ollama.

OpenAI

Il provider predefinito con accesso ai modelli GPT.

export OPENAI_API_KEY="${OPENAI_API_KEY:?Set OPENAI_API_KEY in your environment}"
astreus

ID di modelli da selezionare esplicitamente:

• gpt-6-astra
• gpt-5.6-sol
• gpt-5.6-terra
• gpt-5.6-luna

Modelli ospitati gratuiti tramite OpenRouter

Mantieni ASTREUS_PROVIDER=openai per i modelli ospitati gratuiti. Fornisci una chiave OpenRouter tramite l’ambiente e seleziona il modello esplicitamente. Si applicano gli stessi limiti di richieste e requisiti dell’endpoint della guida LLM del framework.

export OPENAI_BASE_URL="https://openrouter.ai/api/v1"
export OPENAI_API_KEY="${OPENROUTER_API_KEY:?Set OPENROUTER_API_KEY in your environment}"
ASTREUS_PROVIDER=openai ASTREUS_MODEL=openrouter/free astreus

Anthropic (Claude)

Accedi ai modelli Claude per conversazioni raffinate.

export ANTHROPIC_API_KEY="${ANTHROPIC_API_KEY:?Set ANTHROPIC_API_KEY in your environment}"
ASTREUS_PROVIDER=claude ASTREUS_MODEL=claude-sonnet-5 astreus

ID di modelli da selezionare esplicitamente:

• claude-fable-5-1
• claude-opus-5
• claude-sonnet-5
• claude-haiku-4-5-20251001

Google (Gemini)

Usa i modelli Gemini di Google.

export GEMINI_API_KEY="${GEMINI_API_KEY:?Set GEMINI_API_KEY in your environment}"
ASTREUS_PROVIDER=gemini astreus

Modelli disponibili:

• gemini-pro (predefinito) - Gemini Pro
• gemini-pro-vision - Con supporto visione

Ollama (modelli locali)

Esegui modelli localmente con Ollama. Nessuna chiave API richiesta.

# Make sure Ollama is running
ollama serve

# Start CLI with Ollama
ASTREUS_PROVIDER=ollama astreus

Modelli disponibili:

• llama3 (predefinito) - Llama 3
• llama2 - Llama 2
• mistral - Mistral
• codellama - Llama specializzato nel codice

Cambiare provider

All'avvio

Usa le variabili d'ambiente:

ASTREUS_PROVIDER=claude ASTREUS_MODEL=claude-sonnet-5 astreus

Durante la sessione

Usa i comandi slash per cambiare:

/provider claude
/model claude-sonnet-5

Oppure apri il selettore interattivo:

/provider
/model

Configurazione del provider

Endpoint personalizzati

Per deployment enterprise o proxy:

# Ollama on different host
export OLLAMA_HOST=http://192.168.1.100:11434

Supporto visione

Alcuni provider supportano funzionalità di visione (immagini):

# Separate API key for vision (optional)
export OPENAI_VISION_API_KEY=sk-your-vision-key
export ANTHROPIC_VISION_API_KEY=your-vision-key
export GEMINI_VISION_API_KEY=your-vision-key

Supporto embedding

Per le funzionalità di memoria e knowledge:

export OPENAI_EMBEDDING_API_KEY=sk-your-embedding-key
export GEMINI_EMBEDDING_API_KEY=your-embedding-key

Scelta del modello per lo sviluppo degli agenti

Scegli il modello giusto in base al tipo di agente che stai costruendo:

Testare gli agenti su più provider

Quando costruisci agenti, è utile testarli con provider diversi:

# Start developing with fast, cheap model
/provider openai
/model gpt-4o-mini

# Test complex reasoning with top models
/provider claude
/model claude-sonnet-5

# Test locally before deployment
/provider ollama
/model llama3

Questo workflow ti aiuta a capire come si comporta il tuo agente su diversi LLM e a trovare il miglior equilibrio tra capacità, velocità e costo per il tuo caso d'uso.