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

# Hermes Agent'ı CometAPI ile kullanın

> Bu kılavuzu kullanarak Hermes Agent'ı OpenAI uyumlu sohbet veya Anthropic Messages ayarları üzerinden CometAPI'ye bağlayın.

[CometAPI](https://www.cometapi.com)'yi [Hermes Agent](https://hermes-agent.nousresearch.com/docs/) için model sağlayıcısı olarak kullanın. Hermes, bu kılavuzda iki CometAPI yolunu destekler: çoğu metin modeli için genel bir OpenAI uyumlu endpoint ve Anthropic Messages üzerinden bir Claude rotası.

## Ön koşullar

* Git
* Etkin bir API anahtarına sahip bir CometAPI hesabı
* macOS, Linux veya WSL2 üzerinde bir terminal

## Kurulum

<Steps>
  <Step title="CometAPI API anahtarınızı alın">
    [CometAPI konsolu](https://www.cometapi.com/console/token)'na giriş yapın. **Add API Key** seçeneğine tıklayın ve CometAPI API anahtarınızı kopyalayın.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Add API Key düğmesini gösteren CometAPI kontrol paneli" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Base URL'nin gösterildiği CometAPI API anahtarı ayrıntıları" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Hermes Agent'ı yükleyin">
    Aşağıdaki komut resmi yükleyiciyi çalıştırır:

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```

    Geçerli kabuk henüz `hermes` komutunu görmüyorsa, kabuk yapılandırmasını yeniden yükleyin:

    ```bash theme={null}
    source ~/.zshrc
    # or
    source ~/.bashrc
    ```

    <Note>
      Hermes, yapılandırmayı `~/.hermes/` içinde saklar, `hermes` komutunu `~/.local/bin` içine bağlar ve `~/.local/bin` yolunu kabuk PATH'inize ekleyebilir.
    </Note>
  </Step>
</Steps>

## Yapılandırma

Model ailesiyle eşleşen CometAPI rotasını seçin:

| Model ailesi                     | Hermes yapılandırması                                                                       | CometAPI rotası             |
| -------------------------------- | ------------------------------------------------------------------------------------------- | --------------------------- |
| OpenAI uyumlu metin modelleri    | `model.provider: custom` ile `base_url: https://api.cometapi.com/v1`                        | `/v1/chat/completions`      |
| Claude modelleri                 | `transport: anthropic_messages` ile adlandırılmış provider                                  | `/v1/messages`              |
| Hermes içindeki Gemini modelleri | OpenAI uyumlu yapılandırmayı kullanın                                                       | `/v1/chat/completions`      |
| Doğrudan Gemini API çağrıları    | Hermes dışında [Gemini `generateContent` API](/api/text/gemini-generating-content) kullanın | `/v1beta` `generateContent` |

<Warning>
  Hermes'i yerel Gemini sağlayıcısı olarak `https://api.cometapi.com/v1beta` ile yapılandırmayın. Gemini modelleri için OpenAI uyumlu Hermes yapılandırmasını kullanın. Doğrudan Gemini API çağrıları için [Gemini `generateContent` API](/api/text/gemini-generating-content) kullanın.
</Warning>

<Steps>
  <Step title="CometAPI anahtarınızı saklayın">
    `~/.hermes/.env` dosyasını açın ve aşağıdaki değerleri ekleyin:

    ```dotenv theme={null}
    COMETAPI_KEY=<COMETAPI_KEY>
    OPENAI_API_KEY=<COMETAPI_KEY>
    ```

    `COMETAPI_KEY`, adlandırılmış Claude provider tarafından kullanılır. `OPENAI_API_KEY`, Hermes'in özel OpenAI uyumlu endpoint geri dönüşünün çalışmaya devam etmesini sağlar.
  </Step>

  <Step title="OpenAI uyumlu rotayı yapılandırın">
    Bu rotayı, Hermes'ten kullanılan Gemini modelleri dahil olmak üzere çoğu CometAPI metin modeli için kullanın. `~/.hermes/config.yaml` dosyasını açın ve `model` bölümünün şu şekilde göründüğünden emin olun:

    ```yaml theme={null}
    model:
      provider: custom
      default: your-model-id
      base_url: https://api.cometapi.com/v1
    ```

    `your-model-id` değerini [CometAPI Models sayfasındaki](https://www.cometapi.com/models/) güncel bir metin model ID ile değiştirin.

    <Note>
      API anahtarını `~/.hermes/.env` içinde tutun. Gizli bilgileri `config.yaml` içine doğrudan yazmayın.
    </Note>

    <Note>
      Bu kurulum ana sohbet modelini yapılandırır. Hermes, vision veya web extraction gibi görevler için ayrı yardımcı modeller kullanabilir.
    </Note>
  </Step>

  <Step title="Claude Messages rotasını yapılandırın">
    Hermes'in Claude modellerini Anthropic Messages üzerinden çağırmasını istediğinizde bu rotayı kullanın. `~/.hermes/config.yaml` dosyasını açın ve adlandırılmış bir provider kullanın:

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

    `your-claude-model-id` değerini [CometAPI Models sayfasındaki](https://www.cometapi.com/models/) güncel bir Claude model ID ile değiştirin.

    <Note>
      Bu rota için `base_url` değerini `https://api.cometapi.com` olarak bırakın. Hermes, adlandırılmış provider üzerinden Anthropic Messages transport kullanır.
    </Note>
  </Step>
</Steps>

## Doğrulama

<Steps>
  <Step title="Yapılandırmayı kontrol edin">
    Aşağıdaki komut, Hermes'in yapılandırmayı ve API anahtarını okuyabildiğini doğrular:

    ```bash theme={null}
    hermes config check
    ```

    Eğer `hermes config check` bir güncellemeden sonra eksik seçenekler bildirirse, `hermes config migrate` komutunu çalıştırın ve tekrar kontrol edin.
  </Step>

  <Step title="Gerçek bir sohbet testi çalıştırın">
    Aşağıdaki komut, CometAPI üzerinden gerçek bir istek gönderir:

    ```bash theme={null}
    hermes chat -Q --ignore-rules --max-turns 1 -q "Reply with CONNECTED only."
    ```

    Başarılı bir kurulum `CONNECTED` döndürür ve auth veya endpoint hataları vermez. Claude Messages yapılandırması etkin olduğunda bu, Hermes'in CometAPI üzerinden `anthropic_messages` transport kullanabildiğini doğrular.
  </Step>
</Steps>

## İsteğe bağlı yapılandırma

<AccordionGroup>
  <Accordion title="Temiz yeniden kurulum (isteğe bağlı)">
    Daha eski bir Hermes kurulumunu değiştiriyorsanız, önce yerleşik kaldırıcıyı kullanın:

    ```bash theme={null}
    hermes uninstall
    ```

    Kaldırıcıda, CLI, PATH girdisi ve `~/.hermes/` verilerini kaldırmak için **Full uninstall** seçeneğini tercih edin. Ardından kurulum adımını yeniden çalıştırın ve aynı CometAPI yapılandırmasıyla devam edin.
  </Accordion>

  <Accordion title="Bunun yerine hermes model kullanın (isteğe bağlı)">
    OpenAI-compatible route için etkileşimli akışı tercih ediyorsanız, `hermes model` komutunu çalıştırın ve **Custom endpoint** seçeneğini seçin.

    Ardından aşağıdaki değerleri girin:

    * Base URL: `https://api.cometapi.com/v1`
    * API key: CometAPI API anahtarınız
    * Model: geçerli bir CometAPI metin model ID

    Bu akış, OpenAI-compatible provider ayarlarını `config.yaml` içine yazar. Claude Messages için, adlandırılmış provider `transport: anthropic_messages` değerini koruyacak şekilde `config.yaml` dosyasını doğrudan düzenleyin.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#howto",
        "name": "Hermes Agent'ı CometAPI ile kullanın",
        "description": "Hermes Agent'ı OpenAI-compatible chat veya Anthropic Messages ayarları üzerinden CometAPI'ye bağlamak için bu kılavuzu kullanın.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "CometAPI API anahtarınızı alın",
            "text": "CometAPI hesabınızı oluşturun veya açın, ardından kontrol panelinden etkin bir API anahtarını kopyalayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "Hermes Agent'ı yükleyin",
            "text": "Hermes Agent'ı CometAPI ile kullanın kılavuzundaki Hermes Agent'ı yükleyin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "CometAPI anahtarınızı saklayın",
            "text": "Hermes Agent'ı CometAPI ile kullanın kılavuzundaki CometAPI anahtarınızı saklayın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "OpenAI-compatible route'u yapılandırın",
            "text": "Hermes Agent'ı CometAPI ile kullanın kılavuzundaki OpenAI-compatible route'u yapılandırın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "Claude Messages route'unu yapılandırın",
            "text": "Hermes Agent'ı CometAPI ile kullanın kılavuzundaki Claude Messages route'unu yapılandırın adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "Yapılandırmayı kontrol edin",
            "text": "Hermes Agent'ı CometAPI ile kullanın kılavuzundaki Yapılandırmayı kontrol edin adımını tamamlayın."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "Gerçek bir chat testi çalıştırın",
            "text": "Hermes Agent'ı CometAPI ile kullanın kılavuzundaki Gerçek bir chat testi çalıştırın adımını tamamlayın."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI Dokümantasyonu",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Entegrasyonlar",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Hermes Agent'ı CometAPI ile kullanın",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>