Hermes Agent Kurulum Rehberi: Kendi Sunucunda Çalışan AI Agent

Hermes Agent Nedir ve Nasıl Kurulur? Açık Kaynak AI Agent Rehberi

Kendi bilgisayarında çalışan, seni tanıyan ve her gün biraz daha akıllılaşan bir AI agent hayal et. Hermes Agent tam olarak bu. Şubat 2026'da Nous Research tarafından yayımlanan bu açık kaynak proje, GitHub'da 100.000'den fazla star topladı — ve bunun iyi bir nedeni var. Bu rehberde Hermes Agent'ı sıfırdan kurmanı, güvenli şekilde çalıştırmanı ve verimli kullanmanı sağlayacak her adımı bulacaksın.

Hermes Agent Nedir?

Hermes Agent, kendi sunucunda veya bilgisayarında yaşayan bir AI agent. Chatbot değil, IDE eklentisi değil — bağımsız çalışan, görevleri takip eden, Telegram'dan Discord'a birden fazla platformdan erişebildiğin bir sistem.

AI agent nedir? Chatbot'tan ne farkı var?
Bir chatbot (ChatGPT, Gemini gibi) sadece sorduğun soruya cevap verir — konuşma biter, her şey sıfırlanır. AI agent ise senin yerine iş yapar: dosya düzenler, kod yazar, web'de gezinir, e-posta atar, planladığın görevleri hatırlar ve kendi başına çalıştırır. Chatbot pasif bir cevap makinesi gibidir; agent aktif bir çalışan gibi — söylemeni beklemeden harekete geçer, öğrenir, biriktirir.

Farkı şu: çoğu AI aracı her oturumu sıfırdan başlatır. Sen aynı bağlamı, aynı proje detaylarını defalarca anlatmak zorunda kalırsın. Hermes bunu çözüyor. Hafıza sistemi sayesinde seni, projelerini, tercihlerini hatırlıyor. Çözdüğü her problemi "skill" olarak kaydediyor — bir dahaki sefere aynı soruyla karşılaşırsa nereden bakacağını biliyor.

Kısaca ne yapıyor:

• Projelerini ve tercihlerini oturumlar arası hatırlıyor
• Çözdüğü problemlerden otomatik skill dosyaları oluşturuyor
• Telegram, Discord, Slack, WhatsApp, Signal üzerinden erişilebiliyor
• Zamanlanmış görevler çalıştırabiliyor (günlük rapor, haftalık yedek vb.)
• Paralel sub-agent'larla birden fazla iş akışını aynı anda yönetebiliyor
• Tarayıcı otomasyonu, web araması ve kod çalıştırabilme

MIT lisanslı, tamamen ücretsiz. LLM API maliyetleri kullandığın sağlayıcıya göre değişiyor.

MIT lisansı nedir?
MIT, yazılım dünyasının en serbest lisanslarından biri. Bu yazılımı ücretsiz kullanabilirsin, değiştirebilirsin, kendi projende kullanabilirsin — hiçbir kısıt yok. Ticari kullanım da serbest.

GitHub'da 100.000 star ne anlama gelir?
GitHub, geliştiricilerin kod paylaştığı bir platform. "Star" vermek, bir projeyi beğenip kaydetmek gibi — Instagram'daki beğeni gibi düşünebilirsin. 100.000 star, yazılım dünyasında çok ciddi bir ilgi göstergesi. Karşılaştırma için: çoğu popüler açık kaynak proje 10.000–20.000 star bandında kalıyor.

Başlamadan Önce

Neye ihtiyacın var:

• Windows 10/11, macOS veya Linux (Windows'ta artık WSL2 şart değil — native çalışıyor)
• Terminal kullanmayı bilmek (masaüstü uygulamasını seçersen buna da gerek yok)
• Bir LLM API hesabı: Anthropic, OpenAI, OpenRouter veya Nous Portal
• İsteğe bağlı: Telegram/Discord hesabı (mobil erişim istiyorsan)

API hesabı nedir, nasıl alınır?
API, bir yazılımın dışarıya açtığı kapı — sen bu kapıdan Hermes'i bağlıyorsun. ChatGPT'yi tarayıcıdan değil, kendi sisteminden kullanmak istiyorsan OpenAI'dan API key alman gerekiyor.

Windows kullanıcısı için not: Artık native Windows desteği tam — Windows 10 ve 11'de WSL, Cygwin ya da Docker gerekmeden çalışıyor. İki yolun var: çift tıklamalı masaüstü uygulaması ya da PowerShell'de tek satır komut (ikisi de aşağıda). POSIX ortamı isteyen ileri kullanıcılar hâlâ WSL2'yi tercih edebilir ama çoğu kişi için gerek yok.

WSL2 nedir, ne zaman gerekir?
WSL2 (Windows Subsystem for Linux), Windows üzerinde Linux komutlarını çalıştırmana izin veren, Windows'a entegre resmi bir bileşen. Hermes native Windows'ta çalıştığı için kurulum için WSL2 şart değil — sadece web dashboard'un gömülü terminal sekmesi gibi POSIX'e özgü birkaç özellik için gerekiyor. İstersen Windows'taki uygulama mağazasından "Ubuntu" aratıp yükleyebilirsin.

Adım Adım Kurulum

1. Hermes Agent'ı Kur

İki kurulum yolu var. Terminalle uğraşmak istemiyorsan masaüstü uygulaması en kolayı; terminale alışkınsan tek satır komut daha hızlı. İkisi de aynı Hermes'i kuruyor, aynı ayarları ve hafızayı paylaşıyor — birinde başladığın oturum diğerinde devam ediyor.

Yol A — Masaüstü uygulaması (en kolay)

Hermes'in artık macOS, Windows ve Linux için native bir masaüstü uygulaması var. hermes-agent.nousresearch.com adresinden yükleyiciyi indir, çift tıkla, kurulum sihirbazını takip et. Uygulama ilk açılışta arka planda gereken her şeyi (Python, Node, Git) kendisi kuruyor.

Sohbet, ayarlar, model seçimi, skill yönetimi ve zamanlanmış görevlerin hepsini tek pencerede tıklayarak yapıyorsun — YAML dosyası düzenlemek yok. Dosya tarayıcısı, sesli konuşma ve yan yana önizleme de uygulamanın içinde.

Windows SmartScreen uyarısı: Windows yükleyicisi ilk açılışta "bilinmeyen yayıncı" uyarısı verebilir çünkü henüz imzalı değil. Daha fazla bilgi → Yine de çalıştır'a tıklayıp devam edebilirsin.

Yol B — Tek satır komut (terminal)

Windows — PowerShell'e yapıştır ve Enter'a bas:

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

macOS / Linux — Terminal'de çalıştır:

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

Komut gereken her şeyi otomatik kuruyor: Python 3.11, Node.js, uv paket yöneticisi, (Windows'ta) taşınabilir Git ve Hermes'in kendisi. Yönetici (admin) hakkı gerekmiyor, her şey kullanıcı dizinine kuruluyor. İlk kurulum bağımlılıklar inerken birkaç dakika ile 20 dakika arası sürebilir.

Kurulum tamamlandıktan sonra terminali kapat, yeni bir tane aç (PATH'in güncellenmesi için).

2. LLM Sağlayıcını Bağla

hermes setup

Bu komut interaktif bir kurulum sihirbazı açıyor. Şu seçeneklerden birini seçiyorsun:

• Nous Portal — OAuth ile direkt bağlanıyor, tek abonelik 300'den fazla modeli ve araç ağ geçidini (web araması, görsel üretimi, TTS) kapsıyor, en kolay yol
• OpenRouter — 200'den fazla modele tek API key ile erişim
• Anthropic / OpenAI — direkt API key
• DeepSeek — uygun fiyatlı, performanslı seçenek
• Yerel model — Ollama kuruluysa kendi modelini kullanabilirsin

Hangi model seçilmeli? Kalite öncelikliyse Claude Sonnet, bütçe öncelikliyse DeepSeek V4, gizlilik öncelikliyse yerel Llama 4 Maverick.

API key yapıştırma sorunu yaşıyorsan:
PowerShell'e direkt yapıştırmak bazen "non-ASCII karakter" hatasına yol açıyor. Çözüm: API key'i önce Notepad'e yapıştır, orada düzgün göründüğünü teyit et, sonra Notepad'den kopyalayıp PowerShell'e yapıştır.

3. İlk Konuşma

hermes

İnteraktif bir arayüz açılıyor, araçlar ve hafıza sistemi aktif. İlk konuşmada Hermes seni tanımaya başlıyor — projelerini, çalışma şeklini, tercihlerini not alıyor.

4. Telegram'a Bağla (İsteğe Bağlı)

Telefonundan Telegram üzerinden erişmek istiyorsan birkaç adım gerekiyor.

Telegram bot token'ı nasıl alınır:

1. Telegram'da hesap aç (yoksa telegram.org adresinden indir)
2. Arama kutusuna @BotFather yaz, resmi bota git (yanında mavi tik var)
3. /newbot yaz, bot için bir isim belirle
4. BotFather sana bir token verecek — bu token botun şifresi gibi, kimseyle paylaşma

Telegram güvenli mi?
Kurduğun Hermes botu yalnızca senin kullanıcı ID'nden gelen mesajlara cevap verecek şekilde ayarlanıyor — başkası bot adresini bilse bile mesajlarına cevap verilmiyor. Token'ı kimseyle paylaşma; ele geçirilirse bot kontrolü başkasına geçebilir.

Token'ı aldıktan sonra terminale dön:

hermes gateway setup
hermes gateway

Sihirbaz token'ı ve senin Telegram kullanıcı ID'ni soracak. Kullanıcı ID'ni öğrenmek için Telegram'da @userinfobot'a mesaj at, sana numeric bir ID verecek (örn. 123456789).

5. Güncelleme

hermes update

Masaüstü uygulamasını kullanıyorsan güncellemeyi arka planda kendisi kontrol ediyor, tek tıkla yükseltiyor.

Skill Sistemi Nasıl Çalışır?

Bu, Hermes'i diğer agent'lardan ayıran asıl özellik.

Hermes bir problemi çözdüğünde, çözümü SKILL.md formatında bir dosyaya yazıyor. Bir dahaki sefere benzer bir görev geldiğinde, bu skill'i buluyor ve doğrudan kullanıyor — aynı adımları tekrar keşfetmek zorunda kalmıyor.

40'tan fazla hazır skill geliyor: GitHub entegrasyonu, MLOps araçları, diyagram oluşturma, not tutma ve daha fazlası.

Topluluktan skill indirmek için:

hermes skills install [skill-adı]

Kendi yazdığın skill'leri agentskills.io üzerinden paylaşabilirsin.

Zamanlanmış Görevler

Her sabah haber özeti, her gece sistem yedeklemesi, her hafta performans raporu — bunları bir kez tanımlıyorsun, Hermes hallediyor:

hermes schedule "Her sabah 08:00'de hava durumu ve günün yapılacaklar listemi Telegram'a gönder"

Hermes bunu anladığı şekilde otomatik göreve çeviriyor ve çalıştırıyor.

Güvenlik Riskleri ve Dikkat Edilmesi Gerekenler

Hermes güçlü bir araç. Bu güç, dikkatli kullanılmazsa risk de taşıyor.

1. Kendi Makinen, Kendi Sorumluluğun

Hermes senin bilgisayarında çalışıyor. Bu hem avantaj (verin dışarıya çıkmıyor) hem risk (güvenlik açığı bulunursa saldırı yüzeyi senin sistemin).

Ne yapmalısın:

• Hermes'i yönetici (root/admin) kullanıcısıyla çalıştırma
• Gereksiz portları açık bırakma
• SSH erişimi varsa key-based auth kullan, şifre auth'u kapat

2. Her Zaman Güncel Tut

Eski sürümlerde güvenlik açıkları tespit edildi, sonraki güncellemelerde yamalandı. Düzenli güncelleme alışkanlığı edin:

hermes update

3. Skill Ekosistemi Riski

Topluluktan skill indirirken dikkatli ol. Merkezi bir denetim mekanizması henüz tam oturmamış.

Güvenli kullanım:

• Yalnızca resmi agentskills.io üzerinden yayımlanan skill'leri kur
• Skill kaynak kodunu okumadan çalıştırma
• Tanımadığın geliştiricilerin skill'lerini üretim ortamında kullanma

4. API Maliyeti Kontrolden Çıkabilir

Zamanlanmış görevler + paralel görevler + yoğun kullanım birleşince API maliyetin beklenmedik seviyelere çıkabilir.

Ne yapmalısın:

• API sağlayıcında aylık harcama limiti tanımla
• OpenRouter kullanıyorsan budget alert kur
• Başlangıçta ucuz bir model ile test et, sonra yükselt

5. Hafıza Dosyaları Şifrelenmemiş

Hermes tüm hafızasını şu dizinlerde saklar:

• Windows: C:\Users\[kullanıcı adın]\AppData\Local\hermes\
• Linux/macOS: ~/.hermes/

Bu dosyalar şifrelenmemiş düz metin. Paylaşımlı bilgisayar kullanıyorsan başkaları okuyabilir.

Ne yapmalısın:

• Yalnızca kendi kontrolündeki bilgisayarlarda çalıştır
• Paylaşımlı hosting'de kesinlikle kullanma
• Şifre, API key gibi hassas bilgileri Hermes'e söyleme

6. Docker ile Çalıştırmak Daha Güvenli

Docker, Hermes'i bilgisayarının geri kalanından izole ederek çalıştırıyor — bir şeyler ters gitse bile sistem dosyalarına erişemiyor.

Docker nedir?
Docker, uygulamaları kendi "kutusunda" çalıştıran bir sistem. Hermes bu kutunun içinde çalışıyor, dışarıya sınırlı erişimi var. Hem daha güvenli hem de daha kararlı çalışıyor. Kurulum sırasında "Docker backend" seçeneğini tercih et.

Avantajlar

• Gerçek hafıza: Bağlamı bir kez anlat, o artık biliyor. Uzun vadeli projeler için oyun değiştirici.
• Self-hosted, veri güvenliği: Her şey senin makinende. Şirket verisi, kişisel notlar — hiçbiri dışarı çıkmıyor.
• Skill birikimi: Kullandıkça güçleniyor. 6 ay sonraki Hermes ile bugünkü Hermes aynı değil.
• Platform bağımsızlığı: Telefondan Telegram, masaüstünden uygulama ya da CLI, uzaktan SSH — tek sistem, her yerden erişim.
• Açık kaynak: Kaynak koda bakabilirsin, fork edebilirsin, değiştirebilirsin. Vendor lock-in yok.

Sonuç

Hermes Agent, "AI agent" konseptini gerçekten taşıyan ilk açık kaynak projelerden biri. Kalıcı hafıza, skill öğrenmesi ve multi-platform erişim üçlüsü bir arada çalışıyor ve bu kombinasyon şu an rakiplerinin önünde.

Kurulum artık dakikalar sürüyor — özellikle masaüstü uygulamasıyla neredeyse tek tık. Başlangıç için Telegram bağlantısını kur, bir hafta içinde farkı hissediyorsun — Hermes seni tanımaya başlamış oluyor.

Güvenlik konusunda dikkatli ol: güncel tut, Docker kullan, community skill'lerini körü körüne çalıştırma. Bunları gözetirsen, kendi bilgisayarında büyüyen bir AI agent'a sahip oluyorsun.

⚠️ Önemli not: Bu kurulum bilgisayarın açık olduğu sürece çalışır. Windows'ta hermes gateway install komutuyla gateway'i oturum açtığında otomatik başlatabilirsin (Zamanlanmış Görev kullanıyor, yönetici gerekmiyor) — böylece bilgisayarın açıkken Hermes hep erişilebilir olur. Bilgisayarın kapalıyken de 7/24 erişim istiyorsan bir VPS veya cloud sunucu şart. Digital Ocean, Hetzner veya benzeri bir hosting hizmetinde aylık 5–10 dolar bandında Linux sunucu kiralayıp aynı adımları uygulayabilirsin.