Skip to main content
Gebruik CometAPI als modelprovider voor Hermes Agent. Hermes ondersteunt in deze handleiding twee CometAPI-routes: een algemene OpenAI-compatibele endpoint voor de meeste tekstmodellen en een Claude-route via Anthropic Messages.

​
Vereisten

  • Git
  • Een CometAPI-account met een actieve API-sleutel
  • Een terminal op macOS, Linux of WSL2

​
Installatie

1

Haal je CometAPI API-sleutel op

Log in op de CometAPI-console. Klik op Add API Key en kopieer je CometAPI API-sleutel.
CometAPI-dashboard met de knop Add API Key
Details van de CometAPI API-sleutel met de weergegeven basis-URL
2

Installeer Hermes Agent

De volgende opdracht voert het officiële installatieprogramma uit:
Als de huidige shell de opdracht hermes nog niet ziet, laad dan de shellconfiguratie opnieuw:
Hermes slaat configuratie op in ~/.hermes/, koppelt de opdracht hermes in ~/.local/bin en kan ~/.local/bin toevoegen aan je shell-PATH.

​
Configuratie

Kies de CometAPI-route die overeenkomt met de modelfamilie:
Configureer Hermes niet met https://api.cometapi.com/v1beta als een aangepaste Gemini-native provider. Gebruik de OpenAI-compatibele Hermes-configuratie voor Gemini-modellen. Gebruik voor directe Gemini API-calls de Gemini generateContent API.
1

Sla je CometAPI-sleutel op

Open ~/.hermes/.env en voeg de volgende waarden toe:
COMETAPI_KEY wordt gebruikt door de benoemde Claude-provider. OPENAI_API_KEY zorgt ervoor dat Hermes’ fallback voor aangepaste OpenAI-compatibele endpoints blijft werken.
2

Configureer de OpenAI-compatibele route

Gebruik deze route voor de meeste CometAPI-tekstmodellen, inclusief Gemini-modellen die vanuit Hermes worden gebruikt. Open ~/.hermes/config.yaml en zorg ervoor dat de sectie model er zo uitziet:
Vervang your-model-id door een actueel tekst model ID van de CometAPI Models page.
Bewaar de API-sleutel in ~/.hermes/.env. Hardcode geen secrets in config.yaml.
Deze instelling configureert het hoofdchatmodel. Hermes kan aparte hulppmodellen gebruiken voor taken zoals vision of webextractie.
3

Configureer de Claude Messages-route

Gebruik deze route wanneer je wilt dat Hermes Claude-modellen aanroept via Anthropic Messages. Open ~/.hermes/config.yaml en gebruik een benoemde provider:
Vervang your-claude-model-id door een actueel Claude model ID van de CometAPI Models page.
Houd base_url op https://api.cometapi.com voor deze route. Hermes gebruikt het Anthropic Messages-transport van de benoemde provider.

​
Verificatie

1

Controleer de configuratie

Met de volgende opdracht bevestig je dat Hermes de config en de API-sleutel kan lezen:
Als hermes config check na een update ontbrekende opties meldt, voer dan hermes config migrate uit en controleer opnieuw.
2

Voer een echte chattest uit

Met de volgende opdracht verstuur je een echte request via CometAPI:
Een succesvolle setup retourneert CONNECTED en geen auth- of endpointfouten. Wanneer de Claude Messages-configuratie actief is, bevestigt dit dat Hermes het transport anthropic_messages via CometAPI kan gebruiken.

​
Optionele configuratie

Als je een oudere Hermes-installatie vervangt, gebruik dan eerst het ingebouwde verwijderprogramma:
Kies in het verwijderprogramma Volledige verwijdering om de CLI, de PATH-vermelding en de gegevens in ~/.hermes/ te verwijderen. Voer daarna de installatiestap opnieuw uit en ga verder met dezelfde CometAPI-configuratie.
Als je de voorkeur geeft aan de interactieve flow voor de OpenAI-compatibele route, voer dan hermes model uit en kies Custom endpoint.Voer vervolgens de volgende waarden in:
  • Base URL: https://api.cometapi.com/v1
  • API key: je CometAPI API key
  • Model: een actueel CometAPI tekst model ID
Deze flow schrijft de instellingen van de OpenAI-compatibele provider naar config.yaml. Voor Claude Messages bewerk je config.yaml direct, zodat de benoemde provider transport: anthropic_messages behoudt.