Tutorial 12: Setup Nix & NixOS

Selamat datang kembali di seri tutorial Hermes Agent kami! Dalam postingan ini, kita akan membahas cara menginstal Hermes Agent di sistem Nix dan NixOS. Tapi begini — dokumentasi resminya sudah berubah, dan Nix bukan lagi jalur instalasi yang didukung secara eksplisit. Tapi tenang saja! Kamu masih punya opsi, dan kami akan membahas semua yang perlu kamu ketahui.

Apa yang Berubah?

Tim Hermes telah menyederhanakan instalasi secara signifikan. Alih-alih memelihara banyak jalur instalasi, mereka sekarang merekomendasikan installer universal untuk semua orang — termasuk pengguna Nix. Dukungan Nix sekarang bersifat “best-effort saja,” artinya mungkin berfungsi, tapi tidak diuji atau dijamin secara resmi.

Jalur yang Direkomendasikan: Installer Universal

Untuk kebanyakan pengguna, cara termudah untuk menjalankan Hermes Agent adalah dengan installer satu-baris. Ini berfungsi di Linux, macOS, WSL2, dan bahkan Android (Termux):

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

Di Windows native, gunakan PowerShell sebagai gantinya:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Installer menangani semuanya secara otomatis — Python, Node.js, ripgrep, ffmpeg, kloning repo, virtual environment, dan perintah hermes global. Setelah selesai, kamu siap mengobrol.

Bagaimana dengan Setup Khusus Nix?

Jika kamu sudah menggunakan Nix (di NixOS, macOS, atau Linux), masih ada jalur setup khusus dengan Nix flake, modul NixOS deklaratif, dan mode kontainer opsional. Lihat panduan Setup Nix & NixOS di dokumentasi resmi untuk detailnya.

Tapi ini saran kami: coba installer universal dulu. Itu jalur yang didukung resmi, dan dirancang untuk “langsung berfungsi.”

Prasyarat: Tetap Sederhana

Sebelum menjalankan installer, pastikan kamu punya:

Git (wajib di semua platform non-Windows)
curl dan xz-utils di Linux (installer mengunduh Node.js sebagai arsip .tar.xz)
g++ atau build-essential di Debian/Ubuntu (hanya jika kamu berencana menggunakan aplikasi desktop)

Itu saja! Kamu tidak perlu menginstal Python, Node.js, ripgrep, atau ffmpeg secara manual. Installer akan mendeteksi apa yang kurang dan menginstalnya untukmu.

Di Debian/Ubuntu, kamu bisa menyiapkan semuanya dengan:

sudo apt install curl xz-utils build-essential

Setelah Instalasi

Setelah installer selesai, muat ulang shell kamu dan mulai mengobrol:

source ~/.bashrc   # atau: source ~/.zshrc
hermes             # Mulai mengobrol!

Mengonfigurasi Setup Kamu

Setelah instalasi, kamu bisa menyempurnakan pengaturan dengan perintah khusus:

hermes model          # Pilih penyedia LLM dan model
hermes tools          # Konfigurasi tool mana yang diaktifkan
hermes gateway setup  # Siapkan platform perpesanan
hermes config set     # Atur nilai konfigurasi individual
hermes config get     # Periksa nilai konfigurasi individual
hermes setup          # Atau jalankan wizard setup lengkap

Jalur Tercepat: Nous Portal

Ini tips pro: jika kamu ingin melewati repotnya mengatur kunci per-tool, gunakan Nous Portal. Satu langganan mencakup 300+ model plus Tool Gateway (pencarian web, pembuatan gambar, TTS, browser cloud). Mulai dengan satu perintah:

hermes setup --portal

Itu akan login, mengatur Nous sebagai penyediamu, dan mengaktifkan Tool Gateway — semuanya sekaligus.

Pindah dari Mesin Lain?

Jika kamu sudah menjalankan Hermes di mesin lain, kamu tidak perlu membangun ulang semuanya dari nol. Pulihkan backup lengkap dengan hermes import, atau bawa satu agen dengan hermes profile import. Ingat: ekspor profil tidak menyertakan kredensial secara desain, jadi itu bukan backup lengkap. Gunakan hermes backup untuk itu.

Penutup

Meskipun Nix bukan lagi jalur instalasi yang didukung resmi, installer universal membuat setup lebih mudah dari sebelumnya. Untuk kebanyakan pengguna, itulah cara yang tepat — bahkan di NixOS. Jika kamu mengalami masalah, panduan khusus Nix masih tersedia sebagai cadangan.

Selanjutnya di seri kami, kita akan membahas konfigurasi agen pertamamu. Sampai jumpa, selamat mengobrol!