Skip to main content
Usa CometAPI come provider di modelli per Hermes Agent. In questa guida, Hermes supporta due percorsi CometAPI: un endpoint generale compatibile con OpenAI per la maggior parte dei modelli di testo e un percorso Claude tramite Anthropic Messages.

​
Prerequisiti

  • Git
  • Un account CometAPI con una chiave API attiva
  • Un terminale su macOS, Linux o WSL2

​
Installazione

1

Ottieni la tua chiave API CometAPI

Accedi alla console CometAPI. Fai clic su Add API Key e copia la tua chiave API CometAPI.
Dashboard di CometAPI che mostra il pulsante Add API Key
Dettagli della chiave API CometAPI con il base URL mostrato
2

Installa Hermes Agent

Il comando seguente esegue l’installer ufficiale:
Se la shell corrente non riconosce ancora il comando hermes, ricarica la configurazione della shell:
Hermes salva la configurazione in ~/.hermes/, collega il comando hermes in ~/.local/bin e potrebbe aggiungere ~/.local/bin al PATH della tua shell.

​
Configurazione

Scegli la route CometAPI che corrisponde alla famiglia di modelli:
Non configurare Hermes con https://api.cometapi.com/v1beta come provider personalizzato Gemini-native. Usa la configurazione Hermes compatibile con OpenAI per i modelli Gemini. Per chiamate dirette all’API Gemini, usa l’API Gemini generateContent.
1

Memorizza la tua chiave CometAPI

Apri ~/.hermes/.env e aggiungi i seguenti valori:
COMETAPI_KEY è usata dal provider Claude con nome. OPENAI_API_KEY consente di mantenere funzionante il fallback dell’endpoint personalizzato compatibile con OpenAI di Hermes.
2

Configura la route compatibile con OpenAI

Usa questa route per la maggior parte dei modelli di testo CometAPI, inclusi i modelli Gemini usati da Hermes. Apri ~/.hermes/config.yaml e assicurati che la sezione model abbia questo aspetto:
Sostituisci your-model-id con un model ID di testo attuale dalla pagina Modelli di CometAPI.
Mantieni la chiave API in ~/.hermes/.env. Non inserire segreti direttamente in config.yaml.
Questa configurazione imposta il modello di chat principale. Hermes può usare modelli ausiliari separati per attività come la visione o l’estrazione dal web.
3

Configura la route Claude Messages

Usa questa route quando vuoi che Hermes chiami i modelli Claude tramite Anthropic Messages. Apri ~/.hermes/config.yaml e usa un provider con nome:
Sostituisci your-claude-model-id con un model ID Claude attuale dalla pagina Modelli di CometAPI.
Mantieni base_url impostato su https://api.cometapi.com per questa route. Hermes usa il transport Anthropic Messages dal provider con nome.

​
Verifica

1

Controlla la configurazione

Il seguente comando conferma che Hermes può leggere la configurazione e la chiave API:
Se hermes config check segnala opzioni mancanti dopo un aggiornamento, esegui hermes config migrate e controlla di nuovo.
2

Esegui un test reale di chat

Il seguente comando invia una richiesta reale tramite CometAPI:
Una configurazione riuscita restituisce CONNECTED e nessun errore di autenticazione o endpoint. Quando la configurazione Claude Messages è attiva, questo conferma che Hermes può usare il transport anthropic_messages tramite CometAPI.

​
Configurazione facoltativa

Se stai sostituendo una vecchia installazione di Hermes, usa prima il programma di disinstallazione integrato:
Nel programma di disinstallazione, scegli Disinstallazione completa per rimuovere la CLI, la voce PATH e i dati in ~/.hermes/. Poi esegui di nuovo il passaggio di installazione e continua con la stessa configurazione di CometAPI.
Se preferisci il flusso interattivo per il percorso compatibile con OpenAI, esegui hermes model e scegli Custom endpoint.Poi inserisci i seguenti valori:
  • Base URL: https://api.cometapi.com/v1
  • API key: la tua chiave API CometAPI
  • Model: un model ID di testo CometAPI attuale
Questo flusso scrive le impostazioni del provider compatibile con OpenAI in config.yaml. Per Claude Messages, modifica config.yaml direttamente in modo che il provider denominato mantenga transport: anthropic_messages.