Vai al contenuto principale

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 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.