# Hermes

> Daftarkan Vikey sebagai provider di ~/.hermes/config.yaml untuk Hermes Agent.

Hermes Agent memanggil Vikey lewat format OpenAI chat completions.

Diuji dengan Hermes Agent 0.21.2 pada 12 November 2026.

## Langkah

1. Pasang Hermes kalau belum ada:

    ```bash
    curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
    ```

2. Simpan API key di variabel environment:

    ```bash
    export VIKEY_API_KEY=API_KEY_KAMU
    ```

3. Tambahkan provider Vikey dan jadikan model default di `~/.hermes/config.yaml`:

    ```yaml title="~/.hermes/config.yaml"
    model:
      default: vikey/agent-gpt
      provider: vikey
      base_url: https://api.vikey.ai/v1
      key_env: VIKEY_API_KEY
      api_mode: chat_completions

    providers:
      vikey:
        name: Vikey
        base_url: https://api.vikey.ai/v1
        key_env: VIKEY_API_KEY
        model: vikey/agent-gpt
        models:
          vikey/agent-gpt: {}
          openai/gpt-6.1-sol: {}
          deepseek/deepseek-v4.1-flash: {}
    ```

4. Jalankan `hermes`. Untuk ganti model, jalankan `hermes model`, pilih **Vikey**, lalu pilih modelnya.

Cara lain tanpa menyunting file:

```bash
hermes config set providers.vikey.name "Vikey"
hermes config set providers.vikey.base_url "https://api.vikey.ai/v1"
hermes config set providers.vikey.key_env "VIKEY_API_KEY"
hermes model
```

## Masalah umum

| Yang kamu lihat | Penyebab | Solusi |
| --- | --- | --- |
| `Connection error` atau timeout di Hermes Desktop (macOS) | Masalah TLS di HTTP client bawaan Hermes Desktop, bukan di config atau API Vikey | Untuk sementara ganti `base_url` ke `http://api.vikey.ai/v1`, restart Hermes Desktop, lalu kembalikan ke `https` setelah Hermes memperbaikinya |
| `401` | `VIKEY_API_KEY` tidak terbaca | Export ulang, lalu jalankan Hermes dari terminal yang sama |
| `Model '...' not found` | Model id salah ketik | Salin id dari [halaman harga](https://vikey.ai/pricing) |

Pakai `http://` hanya sebagai solusi sementara untuk masalah TLS di atas. Request lewat `http` tidak terenkripsi.

Source: https://docs.vikey.ai/agents/hermes/