Hermes Agent adalah alat coding AI berbasis terminal yang terhubung ke Alibaba Cloud Model Studio melalui pay-as-you-go, Coding Plan, Token Plan Personal Edition, atau Token Plan Team Edition.
Install Hermes Agent
- Jalankan perintah berikut untuk menginstal Hermes Agent. Skrip ini secara otomatis menginstal dependensi seperti Python dan Git.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
CatatanWindows tidak mendukung instalasi native. Instal WSL2 terlebih dahulu, lalu jalankan perintah di atas di WSL2.
- Setelah instalasi, muat ulang lingkungan terminal.
source ~/.bashrc # Jika menggunakan zsh, ubah menjadi source ~/.zshrc
- Verifikasi instalasi. Nomor versi menandakan keberhasilan.
hermes --version
Configure Access Credentials
Jalankan hermes config set untuk mengonfigurasi Base URL dan API Key sesuai rencana yang Anda pilih:
- Token Plan Personal Edition: Langganan pribadi yang memotong Credits pribadi berdasarkan konsumsi token.
- Token Plan Team Edition: Langganan berbasis seat; konsumsi token memotong Credits.
- Coding Plan: Langganan bulanan tetap, dihitung berdasarkan jumlah pemanggilan model.
- Pay-as-you-go: Dibayar setelah pemakaian berdasarkan penggunaan aktual.
CatatanContoh dalam topik ini menggunakan protokol kompatibel Anthropic: Base URL diakhiri dengan /apps/anthropic dan api_mode diatur ke anthropic_messages. Hermes Agent juga mendukung protokol kompatibel OpenAI: ganti akhiran /apps/anthropic pada Base URL dengan /compatible-mode/v1 dan hapus pengaturan api_mode. Sebagai contoh, Base URL kompatibel OpenAI untuk pay-as-you-go (China North 2, Beijing) adalah https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1.
Selain versi command-line, Hermes Agent juga menyediakan versi desktop (Hermes Desktop). Anda dapat mengunduh installer dari website Hermes, atau jalankan hermes desktop setelah menginstal versi command-line. Hermes Desktop dan versi command-line menggunakan file konfigurasi yang sama, yaitu ~/.hermes/config.yaml, sehingga parameter aksesnya identik dengan yang dijelaskan di sini. Saat menghubungkan melalui Custom Endpoint di aplikasi desktop, gunakan Base URL kompatibel OpenAI seperti yang dijelaskan di atas.
Token Plan Personal Edition
Ganti YOUR_API_KEY dengan API Key Token Plan Personal Edition Anda. Daftar model yang tersedia tercantum di model yang didukung.
hermes config set model.provider custom
hermes config set model.base_url https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.8-max
Perintah-perintah ini menulis ke ~/.hermes/config.yaml. Anda juga dapat mengedit file tersebut secara langsung:
contoh config.yaml
model:
default: qwen3.8-max
provider: custom
base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
api_mode: anthropic_messages
api_key: YOUR_API_KEY
Token Plan Team Edition
Ganti YOUR_API_KEY dengan API Key Token Plan Team Edition Anda. Daftar model yang tersedia tercantum di model yang didukung.
hermes config set model.provider custom
hermes config set model.base_url https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.8-max
Perintah-perintah ini menulis ke ~/.hermes/config.yaml. Anda juga dapat mengedit file tersebut secara langsung:
contoh config.yaml
model:
default: qwen3.8-max
provider: custom
base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
api_mode: anthropic_messages
api_key: YOUR_API_KEY
Coding Plan
Ganti YOUR_API_KEY dengan API Key Coding Plan Anda. Daftar model yang tersedia tercantum di model yang didukung.
hermes config set model.provider custom
hermes config set model.base_url https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.7-plus
Perintah-perintah ini menulis ke ~/.hermes/config.yaml. Anda juga dapat mengedit file tersebut secara langsung:
contoh config.yaml
model:
default: qwen3.7-plus
provider: custom
base_url: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
api_mode: anthropic_messages
api_key: YOUR_API_KEY
Pay-as-you-go
Ganti YOUR_API_KEY dengan API Key Alibaba Cloud Model Studio Anda. Daftar model yang tersedia tercantum di API kompatibel Anthropic. Atur base_url sesuai Wilayah Anda. API Key harus sesuai dengan Wilayah yang dipilih, dan ganti WorkspaceId dengan Workspace ID aktual Anda.
- China North 2 (Beijing):
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic - Singapore:
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic.
hermes config set model.provider alibaba
hermes config set model.base_url https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.7-max
Perintah-perintah ini menulis ke ~/.hermes/config.yaml. Anda juga dapat mengedit file tersebut secara langsung:
contoh config.yaml
model:
default: qwen3.7-max
provider: alibaba
base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
api_mode: anthropic_messages
api_key: YOUR_API_KEY
Verify Configuration
Kirim pesan uji untuk memverifikasi konfigurasi Anda:
hermes chat -q "Hello"
Tanggapan yang berhasil menandakan konfigurasi berfungsi. Untuk mengganti model, gunakan parameter -m:
hermes chat -m qwen3.7-max
FAQ
Error Codes
Untuk error konfigurasi, lihat FAQ sesuai rencana penagihan Anda:
- Pay-as-you-go: Pemecahan Masalah Kode Error
- Coding Plan: FAQ Coding Plan
- Token Plan Personal Edition: FAQ Token Plan Personal Edition
- Token Plan Team Edition: FAQ Token Plan Team Edition