Nakama atau Hermes? Bikin AI Agent untuk Tim dari Nol Pakai Docker + Noirly

Mau bikin AI agent sendiri, tapi bingung harus mulai dari agent personal seperti Hermes atau platform seperti Nakama? Di artikel ini kita bandingkan keduanya, lalu langsung setup Nakama dari nol — install Docker, jalankan container, konfigurasi provider Noirly lewat Responses API, sampai menghubungkan ke Telegram.

Cobain Noirly sekarang: https://noirly.ai/register?ref=NLY-497E197D4097

Personal Agent vs Team Agent

AI agent itu bisa dipakai untuk banyak hal — asisten pribadi, customer support, penulis konten, sampai coding assistant. Tapi semakin banyak kebutuhan, semakin sulit kalau semuanya ditangani oleh satu agent dengan satu konfigurasi.

Di sinilah perbedaan antara agent personal seperti Hermes Agent dan platform seperti Nakama mulai terasa.

Nakama vs Hermes Agent

Hermes Agent

Cocok buat kamu yang pengen punya agent personal. Instalasi dan penggunaannya cukup dekat dengan workflow developer — command line, dan berbagai tools yang dijalankan dari terminal.

Kelebihan: Hermes punya kemampuan agent yang bisa berkembang sendiri, termasuk memory dan skills.

Keterbatasan: Ketika agent ingin dipakai banyak orang, kamu perlu mengatur sendiri akses pengguna, interface, isolasi data, dan channel komunikasinya — semuanya manual.

Nakama

Mengambil pendekatan yang berbeda, dirancang untuk penggunaan tim. Ada empat konsep utama:

Singkatnya: Hermes lebih cocok untuk penggunaan personal. Nakama cocok untuk penggunaan tim — dengan organisasi, banyak profile, model dan tools yang bisa diatur berbeda-beda di tiap profile.

Tentang Noirly (Provider yang Dipakai di Tutorial Ini)

Noirly menyediakan akses ke beberapa model melalui API — GPT-5.6 Sol, Terra, Luna, GPT-5.5, dan GPT Image 2. Noirly mengklaim harganya bisa sampai 90% lebih murah dibanding harga resmi OpenAI.

Catatan penting: Harga, model, dan kompatibilitas provider bisa berubah kapan pun — selalu cek dokumentasi terbaru sebelum mengikuti setup ini.

Satu hal yang perlu diketahui: saat ini Noirly hanya menyediakan format Responses API, sementara format chat completions belum tersedia. Ini bisa jadi kendala kalau kamu ingin integrasi Noirly ke agent lain yang tidak support format Responses API.

Langkah 1 — Install Docker

Kalau belum pernah pakai Docker, anggap Docker seperti kotak kemasan untuk aplikasi. Semua kebutuhan aplikasi sudah dibungkus dalam image, jadi kita tidak perlu menginstal setiap komponen satu per satu — tinggal jalankan kotaknya, aplikasinya hidup.

Untuk Windows, download Docker Desktop dari situs resmi Docker dan install seperti aplikasi biasa.

Verifikasi instalasi lewat terminal:

docker --version

Kalau versi Docker muncul, komputer kamu sudah siap menjalankan Nakama.

Langkah 2 — Jalankan Nakama dengan Docker

Tarik image Nakama:

docker pull ghcr.io/ahmadrosid/nakama:latest

Karena baru pertama kali pull image ini, butuh waktu untuk download.

Setelah selesai, jalankan container-nya:

docker run -d -p 4310:4310 -v nakama-/nakama/data --name nakama ghcr.io/ahmadrosid/nakama:latest

Penjelasan flag:

• -p 4310:4310 → membuka akses agar Nakama bisa diakses dari browser

• -v nakama-/nakama/data → membuat volume penyimpanan, supaya data organization, profile, session, dan database tidak hilang saat container dihentikan atau dijalankan ulang

Buka browser, akses:

http://localhost:4310

Kalau semuanya benar, kamu akan melihat setup wizard Nakama.

Langkah 3 — Setup Wizard dan Konfigurasi Provider Noirly

Wizard Nakama dimulai dari pembuatan admin account:

1. Isi nama, email, dan password

2. Buat organization pertama — anggap ini sebagai kantor atau ruang kerja untuk tim kamu

3. Pilih provider model

Nakama mendukung beberapa provider: OpenAI, Anthropic, OpenRouter, Gemini, DeepSeek, Ollama, dan provider custom.

Konfigurasi Custom Provider untuk Noirly

Pilih provider yang mendukung format Responses API, lalu masukkan:

• Base URL — ambil dari dashboard Noirly, menu Setup

• API Key — ambil dari dashboard Noirly, menu API Key

• Nama model yang ingin dipakai

Setelah base URL, API key, dan model diisi, lanjut ke pemilihan zona waktu. Kalau konfigurasi berhasil, Nakama sudah siap dipakai.

⚠️ Jangan pernah bagikan API key kamu ke publik.

Langkah 4 — Testing Request Pertama

Setelah provider disimpan, model perlu di-assign ke profile. Di Nakama, model dipilih per profile — ini penting karena nanti profile Default Bot bisa memakai model yang berbeda dari Super Bot.

Untuk test pertama, jangan langsung minta yang rumit. Kirim prompt yang gampang diverifikasi:

Jelaskan fungsi organization dan profile di Nakama dalam lima bullet point.

Kalau jawaban muncul, berarti provider, model, dan streaming dasar sudah bekerja.

Kalau respons gagal, periksa tiga hal ini:

1. Base URL sudah benar?

2. API key valid?

3. Nama model sesuai dan tersedia di akun Noirly?

Langkah 5 — Membuat Profile AI Agent

Masuk ke menu Profiles, buat profile baru — misalnya Support Agent.

Setiap profile sebaiknya punya satu peran yang jelas. Identitas dan perilaku profile diatur lewat beberapa file:

Setiap profile juga bisa diberi model dan tools yang berbeda. Misalnya:

• Agent support butuh knowledge base

• Agent coding memerlukan akses file dan coding agent

💡 Kalau sudah punya profile yang bagus, gunakan fitur Clone untuk membuat variasi baru tanpa perlu mulai dari nol.

Langkah 6 — Menghubungkan Telegram

Sekarang buat agent bisa dipakai di luar dashboard lewat channel Telegram.

1. Buka @BotFather di Telegram, ambil token bot

2. Di Nakama, masuk ke menu Integrations, pilih Telegram

3. Tempel token bot

4. Pilih profile mana yang akan menjawab pesan di Telegram

Nakama akan memberikan pairing code — kode ini berfungsi sebagai pengaman agar tidak semua orang bisa langsung memakai bot kamu.

Setelah pairing selesai, kirim pesan dari Telegram dan lihat apakah agent membalas. Kalau dibalas, setup sudah berhasil.

WhatsApp juga bisa dikoneksikan pakai QR code atau pairing code kalau dibutuhkan.

Use Case untuk Tim dan Multi-Client

Dengan arsitektur ini, ada beberapa use case yang langsung kelihatan:

1. Support agent untuk bisnis kecil Agent bisa diberi knowledge base produk dan menjawab pertanyaan pelanggan melalui WhatsApp.

2. Workflow konten Buat profile penulis untuk riset dan draft, lalu profile editor untuk melakukan review. Tools dan modelnya bisa dibedakan supaya lebih terkontrol.

3. Agency multi-client Buat organization terpisah untuk tiap client, sehingga akses dan data tidak bercampur. Ini salah satu pembeda penting Nakama dibanding agent personal yang berjalan di satu mesin.

Kamu juga bisa membuat automation terjadwal, seperti laporan harian, rekap pekerjaan, atau mengirim notifikasi ke Telegram.

Ringkasan Perintah

# Cek instalasi Docker
docker --version

# Pull image Nakama
docker pull ghcr.io/ahmadrosid/nakama:latest

# Jalankan container Nakama
docker run -d -p 4310:4310 -v nakama-/nakama/data --name nakama ghcr.io/ahmadrosid/nakama:latest

# Akses dashboard
# http://localhost:4310

Ringkasan Workflow

Jadi, Nakama atau Hermes?

Kalau kamu ingin agent personal yang bisa berkembang sendiri lewat terminal, Hermes bisa jadi pilihan menarik.

Tapi kalau kamu ingin platform AI agent untuk tim, dengan banyak organization yang terisolasi, banyak profile dengan peran berbeda, dan bisa dihubungkan ke Telegram/WhatsApp langsung dari dashboard — Nakama lebih cocok.

Sumber: https://youtu.be/snN7KkxHf5U