Vai al contenuto principale
Usa CometAPI come provider del modello per Hermes Agent tramite il supporto di Hermes per endpoint personalizzati compatibili con OpenAI.

​
Prerequisiti

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

​
Installazione

1

Ottieni la tua API key di CometAPI

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

Installa Hermes Agent

Il comando seguente esegue l’installer ufficiale:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Se la shell corrente non vede ancora il comando hermes, ricarica la configurazione della shell:
source ~/.zshrc
# or
source ~/.bashrc
Hermes salva la configurazione in ~/.hermes/, collega il comando hermes in ~/.local/bin e può aggiungere ~/.local/bin al PATH della shell.

​
Configurazione

1

Salva la tua chiave CometAPI

Apri ~/.hermes/.env e aggiungi la seguente riga:
OPENAI_API_KEY=<COMETAPI_KEY>
Hermes usa OPENAI_API_KEY come fallback di autenticazione per endpoint personalizzati compatibili con OpenAI.
2

Configura l'endpoint CometAPI

Apri ~/.hermes/config.yaml e assicurati che la sezione model sia simile a questa:
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 Models di CometAPI.
Mantieni la API key in ~/.hermes/.env. Non inserire segreti direttamente in config.yaml.
Questa configurazione imposta il modello principale per la chat. Hermes può usare modelli ausiliari separati per attività come vision o web extraction.

​
Verifica

1

Controlla la configurazione

I seguenti comandi confermano che Hermes può leggere la configurazione e la API key:
hermes config check
hermes doctor
hermes status
Se hermes config check segnala opzioni mancanti dopo un aggiornamento, esegui hermes config migrate e controlla di nuovo.
2

Esegui un test di chat reale

Il comando seguente invia una richiesta reale tramite CometAPI:
hermes chat -q "Reply with the single word CONNECTED."
Una configurazione riuscita restituisce CONNECTED e nessun errore di autenticazione o endpoint.

​
Configurazione opzionale

Se stai sostituendo un’installazione Hermes precedente, usa prima il programma di disinstallazione integrato:
hermes uninstall
Nel programma di disinstallazione, scegli Full uninstall per rimuovere la CLI, la voce nel PATH e i dati in ~/.hermes/. Poi esegui di nuovo il passaggio di installazione e continua con la stessa configurazione CometAPI.
Se preferisci il flusso interattivo, esegui hermes model e scegli Custom endpoint.Quindi inserisci i seguenti valori:
  • Base URL: https://api.cometapi.com/v1
  • API key: la tua API key di CometAPI
  • Model: un model ID di testo attuale di CometAPI
Questo flusso scrive le stesse impostazioni del provider in config.yaml.