Skip to main content
Użyj CometAPI jako dostawcy modeli dla Hermes Agent. Hermes obsługuje w tym przewodniku dwie ścieżki CometAPI: ogólny endpoint zgodny z OpenAI dla większości modeli tekstowych oraz trasę Claude przez Anthropic Messages.

​
Wymagania wstępne

  • Git
  • Konto CometAPI z aktywnym kluczem API
  • Terminal w systemie macOS, Linux lub WSL2

​
Instalacja

1

Pobierz klucz API CometAPI

Zaloguj się do konsoli CometAPI. Kliknij Add API Key i skopiuj swój klucz API CometAPI.
Panel CometAPI pokazujący przycisk Add API Key
Szczegóły klucza API CometAPI z widocznym base URL
2

Zainstaluj Hermes Agent

Poniższe polecenie uruchamia oficjalny instalator:
Jeśli bieżąca powłoka jeszcze nie widzi polecenia hermes, przeładuj konfigurację powłoki:
Hermes przechowuje konfigurację w ~/.hermes/, linkuje polecenie hermes w ~/.local/bin i może dodać ~/.local/bin do PATH powłoki.

​
Konfiguracja

Wybierz trasę CometAPI, która odpowiada rodzinie modeli:
Nie konfiguruj Hermes z https://api.cometapi.com/v1beta jako niestandardowego providera natywnego dla Gemini. Dla modeli Gemini użyj w Hermes konfiguracji zgodnej z OpenAI. W przypadku bezpośrednich wywołań API Gemini użyj API Gemini generateContent.
1

Zapisz swój klucz CometAPI

Otwórz ~/.hermes/.env i dodaj następujące wartości:
COMETAPI_KEY jest używany przez nazwany provider Claude. OPENAI_API_KEY sprawia, że awaryjny niestandardowy endpoint zgodny z OpenAI w Hermes nadal działa.
2

Skonfiguruj trasę zgodną z OpenAI

Użyj tej trasy dla większości tekstowych modeli CometAPI, w tym modeli Gemini używanych z Hermes. Otwórz ~/.hermes/config.yaml i upewnij się, że sekcja model wygląda tak:
Zastąp your-model-id aktualnym model ID modelu tekstowego ze strony modeli CometAPI.
Przechowuj klucz API w ~/.hermes/.env. Nie zapisuj sekretów na stałe w config.yaml.
Ta konfiguracja ustawia główny model czatu. Hermes może używać oddzielnych modeli pomocniczych do zadań takich jak vision lub ekstrakcja z sieci.
3

Skonfiguruj trasę Claude Messages

Użyj tej trasy, gdy chcesz, aby Hermes wywoływał modele Claude przez Anthropic Messages. Otwórz ~/.hermes/config.yaml i użyj nazwanego providera:
Zastąp your-claude-model-id aktualnym model ID Claude ze strony modeli CometAPI.
Dla tej trasy pozostaw base_url ustawione na https://api.cometapi.com. Hermes używa transportu Anthropic Messages z nazwanego providera.

​
Weryfikacja

1

Sprawdź konfigurację

Poniższe polecenie potwierdza, że Hermes może odczytać konfigurację i klucz API:
Jeśli hermes config check zgłasza brakujące opcje po aktualizacji, uruchom hermes config migrate i sprawdź ponownie.
2

Uruchom rzeczywisty test czatu

Poniższe polecenie wysyła rzeczywiste żądanie przez CometAPI:
Pomyślna konfiguracja zwraca CONNECTED i brak błędów uwierzytelniania lub endpointu. Gdy konfiguracja Claude Messages jest aktywna, potwierdza to, że Hermes może używać transportu anthropic_messages przez CometAPI.

​
Opcjonalna konfiguracja

Jeśli zastępujesz starszą instalację Hermes, najpierw użyj wbudowanego deinstalatora:
W deinstalatorze wybierz Full uninstall, aby usunąć CLI, wpis PATH oraz dane ~/.hermes/. Następnie ponownie uruchom krok instalacji i kontynuuj z tą samą konfiguracją CometAPI.
Jeśli wolisz interaktywny przepływ dla ścieżki zgodnej z OpenAI, uruchom hermes model i wybierz Custom endpoint.Następnie wprowadź następujące wartości:
  • Base URL: https://api.cometapi.com/v1
  • API key: twój klucz API CometAPI
  • Model: aktualny model ID modelu tekstowego CometAPI
Ten przepływ zapisuje ustawienia dostawcy zgodnego z OpenAI do config.yaml. W przypadku Claude Messages edytuj config.yaml bezpośrednio, aby nazwany dostawca zachował transport: anthropic_messages.