Cara Setup Hermes AI Agent: Panduan Lengkap dari A-Z 2026

Cara setup Hermes AI Agent sebenarnya cukup sederhana: clone repository, install dependencies, konfigurasi API key, dan jalankan agent. Tapi ada beberapa langkah penting yang sering dilewatkan pemula sehingga menyebabkan error. Panduan ini akan memandu kamu langkah demi langkah — dari menyiapkan environment hingga agent pertama kamu berjalan dengan sukses. Tidak perlu jadi expert Linux, cukup ikuti langkah-langkahnya.

Persiapan Sebelum Setup

Sebelum memulai, pastikan sistem kamu memenuhi persyaratan berikut:

Minimum Requirements

• Sistem Operasi: Ubuntu 22.04+ atau Debian 12+ (Recommended). Bisa juga macOS 14+ atau Windows via WSL2
• Python: 3.10 atau lebih baru
• RAM: Minimal 4GB (8GB recommended)
• Storage: 5GB free space
• Git: Sudah terinstall
• API Key: Minimal dari satu LLM provider (OpenAI, Anthropic, atau Google)

Yang Perlu Disiapkan

• Akses terminal (Linux/macOS) atau WSL2 (Windows)
• API key dari provider LLM pilihan
• Koneksi internet yang stabil

Langkah 1: Install Dependencies Sistem

Buka terminal dan jalankan perintah berikut untuk menginstall dependencies yang dibutuhkan:

sudo apt update && sudo apt upgrade -y
sudo apt install -y python3 python3-pip python3-venv git curl wget

Untuk macOS, gunakan Homebrew:

brew install python3 git curl wget

Langkah 2: Clone Repository Hermes Agent

Clone repository resmi dari GitHub:

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

Ini akan mendownload semua kode Hermes Agent ke folder hermes-agent.

Langkah 3: Buat Virtual Environment

Best practice untuk Python projects adalah menggunakan virtual environment agar tidak mengganggu package sistem:

python3 -m venv venv
source venv/bin/activate

Setelah ini, kamu akan melihat (venv) di awal terminal prompt — tandanya virtual environment aktif.

Langkah 4: Install Dependencies Python

Install semua package Python yang dibutuhkan Hermes Agent:

pip install --upgrade pip
pip install -r requirements.txt

Proses ini可能需要 5-10 menit tergantung koneksi internet. Packages yang diinstall termasuk: openai, anthropic, chromadb (untuk memory), requests, dan library pendukung lainnya.

Langkah 5: Konfigurasi Environment Variables

Hermes Agent membaca konfigurasi dari file .env atau environment variables. Buat file .env di folder utama:

cp .env.example .env
nano .env

Edit file .env dan isi dengan API key kamu. Minimal satu provider harus diisi:

# OpenAI
OPENAI_API_KEY=sk-your-openai-api-key-here

# Optional: Anthropic
ANTHROPIC_API_KEY=sk-ant-your-anthropic-api-key-here

# Optional: Google Gemini
GOOGLE_API_KEY=your-google-api-key-here

# Optional: OpenRouter (akses banyak model dari satu API)
OPENROUTER_API_KEY=sk-or-your-openrouter-key-here

# Konfigurasi Agent
HERMES_MODEL=gpt-4o
HERMES_MEMORY_TYPE=chroma

Langkah 6: Setup Database Memory

Hermes Agent menggunakan ChromaDB untuk persistent memory. Setup database-nya dengan:

python scripts/setup_memory.py

Script ini akan membuat folder memory/ yang berisi database ChromaDB. Semua memori agent akan disimpan di sini.

Langkah 7: Jalankan Hermes Agent

Sekarang saatnya menjalankan agent untuk pertama kali:

python run_agent.py

Jika berhasil, kamu akan melihat output seperti ini:

Hermes Agent v0.10.0
Model: gpt-4o
Memory: ChromaDB (persistent)
Tools: search, code, file, web

> Ready! How can I help you today?

Langkah 8: Setup Cron Jobs (Opsional)

Untuk menjalankan tugas otomatis, aktifkan cron job Hermes Agent:

python scripts/setup_cron.py

Kamu bisa menambahkan tugas cron dengan format:

# Di file cron_config.yaml
jobs:
  - schedule: "0 8 * * *"  # Setiap jam 08.00
    task: "Review email inbox dan buat summary"
  - schedule: "0 */6 * * *"  # Setiap 6 jam
    task: "Scrape berita teknologi terbaru"

Verifikasi Setup Berhasil

Untuk memastikan semuanya berjalan dengan benar, coba perintah sederhana:

> hitung 150 * 27 + 83

Jika agent menjawab dengan benar, setup kamu berhasil! Selanjutnya, coba fitur memory:

> ingat bahwa nama proyek saya adalah "HermesTest"
> apa nama proyek saya?

Troubleshooting Masalah Umum

Error: ModuleNotFoundError

Pastikan virtual environment aktif dan semua dependencies terinstall. Jalankan ulang: pip install -r requirements.txt

Error: API key not found

Pastikan file .env sudah benar dan tidak ada typo. Coba load manual: export $(grep -v '^#' .env | xargs)

Error: Port already in use

Jika port default (8000) sudah dipakai, ubah di konfigurasi: HERMES_PORT=8001

Agent tidak merespon

Cek koneksi internet dan pastikan API key masih aktif. Coba test API key secara terpisah dengan curl.

Perbandingan Metode Setup

Kesimpulan

Setup Hermes AI Agent memang membutuhkan sedikit usaha di awal, terutama bagi yang belum terbiasa dengan terminal. Tapi setelah berhasil, kamu akan punya AI agent pribadi yang powerful, gratis, dan terus belajar. Panduan ini mencakup 99% kasus setup yang akan kamu hadapi. Kalau mentok, komunitas Nous Research di GitHub dan Discord sangat aktif membantu.

FAQ

Apakah Hermes Agent bisa diinstall di Windows?
Bisa via WSL2 (Windows Subsystem for Linux) atau Docker Desktop. Native Windows belum didukung secara resmi.

Berapa biaya API key per bulan?
Tergantung pemakaian. Untuk penggunaan ringan (50-100 task/hari), sekitar $5-15/bulan dengan GPT-4o mini.

Apakah bisa pakai model lokal gratis?
Bisa. Install Ollama, download model seperti Llama 3 atau Qwen 2.5, dan arahkan Hermes Agent ke endpoint lokal.

Kenapa setup saya gagal terus?
Penyebab paling umum: Python version terlalu tua (<3.10), virtual environment tidak aktif, atau API key salah. Cek satu per satu.

Apakah perlu GPU untuk menjalankan Hermes Agent?
Tidak wajib. GPU diperlukan hanya kalau kamu menggunakan model lokal. Untuk API-based (GPT-4, Claude), CPU sudah cukup.

Bagaimana cara update Hermes Agent?
git pull origin main lalu pip install -r requirements.txt --upgrade. Kesimpulan: Sangat mudah.

Apakah Hermes Agent bisa di-uninstall?
Tinggal hapus folder hermes-agent dan file .env. Semua data memori ada di folder memory/ — backup dulu kalau diperlukan.

Bisakah setup Hermes Agent di HP Android?
Bisa melalui Termux, tapi tidak direkomendasikan karena keterbatasan resource. Lebih baik setup di VPS murah (start from $5/bulan).

Support apa saja yang tersedia jika error?
GitHub Issues, Discord komunitas Nous Research, dan forum Reddit r/LocalLLaMA. Tim developer cukup responsif di GitHub.

Apakah data saya aman dengan Hermes Agent?
Ya. Semua data lokal, tidak dikirim ke server pihak ketiga. Kalaupun pakai API cloud, hanya prompt yang dikirim — memori tetap di lokal.