> ## Documentation Index
> Fetch the complete documentation index at: https://docs.triw.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent

> Instal Hermes Agent dan tambahkan Triw sebagai provider di config.yaml.

Hermes Agent adalah agent terminal dari Nous Research. Provider dideklarasikan di `~/.hermes/config.yaml`, baik lewat halaman Models di dashboard maupun mengedit file langsung.

## Kebutuhan sistem

| Item | Catatan |
| - | - |
| OS | macOS, Linux, Windows |
| Python | disediakan installer; tidak perlu setup manual |

## Instalasi

Gunakan desktop installer dari [hermes-agent.nousresearch.com](https://hermes-agent.nousresearch.com/docs/getting-started/installation) untuk macOS/Windows, atau instal CLI:

```bash Linux / macOS / WSL2 theme={null}
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```

```powershell Windows theme={null}
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
```

```bash theme={null}
hermes --version
```

Pada instalasi yang sudah ada, `hermes update` menjaga CLI dan skema config tetap mutakhir.

## Konfigurasi

Tambahkan entri provider dan arahkan model utama ke sana:

```yaml ~/.hermes/config.yaml theme={null}
providers:
  triw:
    api: https://router.triw.io/v1
    api_key: sk-...

model:
  provider: triw
  default: claude-sonnet-4-5
  base_url: https://router.triw.io/v1
  api_mode: chat_completions
```

```bash theme={null}
export TRIW_API_KEY="sk-..."   # lalu gunakan api_key: ${TRIW_API_KEY} bila lebih suka
```

Arti field:

| Field | Arti |
| - | - |
| `providers.<name>.api` | Base URL endpoint |
| `providers.<name>.api_key` | Kredensial; literal atau `${ENV_VAR}` |
| `providers.<name>.extra_headers` | Header tambahan untuk setiap request |
| `model.provider` | Provider yang dipakai sesi baru |
| `model.api_mode` | `chat_completions` untuk `/v1/chat/completions` |

Config lama memakai daftar `custom_providers:` dengan `base_url`; masih dimuat dan dimigrasi otomatis saat update.

## Verifikasi

```bash theme={null}
hermes "balas dengan satu kata: ready"
```

Lalu cek **Logs** Triw. Di dalam sesi, `/model` berpindah model dan menampilkan provider yang melayaninya.

## Troubleshooting

| Gejala | Penyebab | Perbaikan |
| - | - | - |
| `401` | Key tidak terbaca proses | Export variabel di shell peluncur, atau tulis key langsung |
| Daftar model kosong | Provider belum dipilih | Set `model.provider: triw` |
| Stream gaya Anthropic rusak | `api_mode` salah | Pakai `chat_completions` untuk `/v1/*` |
| Config diabaikan | Mengedit profil berbeda | Pastikan `~/.hermes/config.yaml` adalah profil aktif |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.