> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Usa Hermes Agent con CometAPI
> Usa questa guida per collegare Hermes Agent a CometAPI tramite impostazioni chat compatibili con OpenAI o Anthropic Messages.
Usa [CometAPI](https://www.cometapi.com) come provider di modelli per [Hermes Agent](https://hermes-agent.nousresearch.com/docs/). 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
Accedi alla [console CometAPI](https://www.cometapi.com/console/token). Fai clic su **Add API Key** e copia la tua chiave API CometAPI.
Il comando seguente esegue l'installer ufficiale:
```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```
Se la shell corrente non riconosce ancora il comando `hermes`, ricarica la configurazione della shell:
```bash theme={null}
source ~/.zshrc
# or
source ~/.bashrc
```
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:
| Famiglia di modelli | Configurazione Hermes | Route CometAPI |
| --------------------------------------- | ----------------------------------------------------------------------------------------------- | --------------------------- |
| Modelli di testo compatibili con OpenAI | `model.provider: custom` con `base_url: https://api.cometapi.com/v1` | `/v1/chat/completions` |
| Modelli Claude | Provider con nome con `transport: anthropic_messages` | `/v1/messages` |
| Modelli Gemini in Hermes | Usa la configurazione compatibile con OpenAI | `/v1/chat/completions` |
| Chiamate dirette all'API Gemini | Usa l'API [Gemini `generateContent`](/api/text/gemini-generating-content) al di fuori di Hermes | `/v1beta` `generateContent` |
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`](/api/text/gemini-generating-content).
Apri `~/.hermes/.env` e aggiungi i seguenti valori:
```dotenv theme={null}
COMETAPI_KEY=
OPENAI_API_KEY=
```
`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.
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:
```yaml theme={null}
model:
provider: custom
default: your-model-id
base_url: https://api.cometapi.com/v1
```
Sostituisci `your-model-id` con un model ID di testo attuale dalla [pagina Modelli di CometAPI](https://www.cometapi.com/models/).
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.
Usa questa route quando vuoi che Hermes chiami i modelli Claude tramite Anthropic Messages. Apri `~/.hermes/config.yaml` e usa un provider con nome:
```yaml theme={null}
model:
provider: cometapi-claude
default: your-claude-model-id
providers:
cometapi-claude:
base_url: https://api.cometapi.com
key_env: COMETAPI_KEY
transport: anthropic_messages
default_model: your-claude-model-id
```
Sostituisci `your-claude-model-id` con un model ID Claude attuale dalla [pagina Modelli di CometAPI](https://www.cometapi.com/models/).
Mantieni `base_url` impostato su `https://api.cometapi.com` per questa route. Hermes usa il transport Anthropic Messages dal provider con nome.
## Verifica
Il seguente comando conferma che Hermes può leggere la configurazione e la chiave API:
```bash theme={null}
hermes config check
```
Se `hermes config check` segnala opzioni mancanti dopo un aggiornamento, esegui `hermes config migrate` e controlla di nuovo.
Il seguente comando invia una richiesta reale tramite CometAPI:
```bash theme={null}
hermes chat -Q --ignore-rules --max-turns 1 -q "Reply with CONNECTED only."
```
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:
```bash theme={null}
hermes uninstall
```
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`.