Install Hermes Agent di Ubuntu/Linux adalah proses yang straightforward: cukup 6 langkah — install dependencies, clone repo, buat virtual environment, install packages, konfigurasi API key, dan jalankan agent. Panduan ini dirancang khusus untuk pemula yang baru pertama kali menggunakan terminal Linux. Setiap perintah dijelaskan fungsinya, jadi kamu tidak hanya copas — tapi juga pahami apa yang dilakukan.
Kenapa Linux adalah Platform Terbaik untuk Hermes Agent?
Hermes Agent dikembangkan dan diuji terutama di lingkungan Linux. Ada beberapa alasan kenapa Linux jadi pilihan utama:
- Native support: Semua fitur berjalan optimal tanpa emulasi
- Python ecosystem: Package management lebih stabil dibanding Windows
- Performance: Lebih efisien dalam penggunaan RAM dan CPU
- Cron jobs: Built-in task scheduler yang terintegrasi rapi
- Docker support: Mudah di-deploy dalam container
Langkah 1: Update Sistem & Install Prerequisites
Buka terminal (Ctrl+Alt+T) dan jalankan:
sudo apt update && sudo apt upgrade -y
sudo apt install -y python3 python3-pip python3-venv git curl wget nano
Perintah ini akan mengupdate package list, mengupgrade package yang sudah ada, dan menginstall tools yang diperlukan: Python 3, pip (package manager Python), venv (virtual environment), git (version control), dan nano (text editor).
Langkah 2: Verifikasi Python Version
Pastikan Python version 3.10 atau lebih baru:
python3 --version
Jika output menunjukkan < 3.10, upgrade Python dengan:
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.11 python3.11-venv python3.11-pip
Langkah 3: Clone Repository Hermes Agent
cd ~
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
Repository akan di-clone ke folder ~/hermes-agent. ~ adalah shortcut untuk home directory kamu.
Langkah 4: Setup Virtual Environment & Install Packages
python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
Virtual environment mencegah konflik package dengan project Python lain di sistem kamu.
Langkah 5: Konfigurasi API Key
cp .env.example .env
nano .env
Edit file .env dan isi minimal satu API key. Yang paling mudah — daftar di platform.openai.com, buat API key, dan paste di sini:
OPENAI_API_KEY=sk-proj-xxxxxxxxxxx
Simpan dengan Ctrl+X, lalu Y, lalu Enter.
Langkah 6: Setup Memory & Jalankan Agent
source venv/bin/activate
python scripts/setup_memory.py
python run_agent.py
Jika berhasil, kamu akan melihat prompt siap menerima perintah.
Langkah 7: Test Agent Pertama Kamu
> Halo, siapa kamu?
> Buatkan file hello_world.txt dengan isi 'Hello from Hermes!'
Jika agent merespon dan file berhasil dibuat — selamat! Hermes Agent kamu sudah siap digunakan.
Troubleshooting Khas Linux
| Error | Penyebab | Solusi |
|---|---|---|
| Command not found | Package belum terinstall | Jalankan sudo apt install [package] |
| Permission denied | Tidak punya akses | Gunakan sudo atau chmod |
| pip not found | pip belum terinstall | sudo apt install python3-pip |
| ModuleNotFoundError | Virtual env tidak aktif | Jalankan source venv/bin/activate |
Kesimpulan
Install Hermes Agent di Ubuntu/Linux adalah proses yang sangat manageable, bahkan untuk pemula. Kuncinya: ikuti langkah berurutan, jangan skip virtual environment, dan pastikan API key benar. Dengan agent yang sudah berjalan, kamu siap mengeksplorasi berbagai fitur canggih Hermes Agent.
FAQ
Apakah bisa install di Ubuntu versi lama?
Minimal Ubuntu 20.04, tapi recommended 22.04 atau 24.04 LTS.
Berapa space yang dibutuhkan?
~500MB untuk kode + dependencies, ~1-2GB untuk memory database seiring pemakaian.
Apakah butuh koneksi internet terus?
Hanya saat pertama kali install dan saat agent memanggil API LLM. Untuk model lokal, internet tidak diperlukan.
Bisa install di Raspberry Pi?
Bisa di Pi 4/5 with 4GB+ RAM, tapi performa terbatas.
Bagaimana cara restart agent?
Ctrl+C untuk stop, lalu python run_agent.py lagi untuk start.
Apakah aman install di laptop pribadi?
Aman. Hermes Agent tidak mengubah sistem secara permanen.
Bisa install tanpa git?
Bisa — download ZIP dari GitHub, extract, dan lanjut ke langkah 4.
Bagaimana uninstall?
Cukup hapus folder ~/hermes-agent dan ~/.hermes.
Kalau ada error dependency?
Pastikan Python 3.10+ dan coba pip install --upgrade -r requirements.txt.
Apakah support Fedora/Arch?
Bisa, tapi ganti apt dengan dnf (Fedora) atau pacman (Arch).
🚀 Mulai Belajar AI Sekarang!
Dapatkan akses ke materi belajar AI yang terstruktur dan mudah dipahami.
Lihat Paket Belajar →