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:

• Linux, macOS veya WSL2 kurulu bir Windows makinesi
• Terminal kullanmayı bilmek (temel düzey yeterli)
• 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: Native Windows desteği deneysel aşamada. WSL2 kurarak Ubuntu üzerinden ilerlemenizi öneririm — kararlı çalışıyor.

WSL2 nedir?
WSL2 (Windows Subsystem for Linux), Windows üzerinde Linux komutlarını çalıştırmana izin veren Microsoft'un resmi aracı. Ayrı bir bilgisayara ihtiyaç yok — Windows'un içinde Linux gibi davranıyor. Microsoft Store'dan "Ubuntu" aratıp yükleyebilirsin.

Adım Adım Kurulum

1. Hermes Agent'ı Kur

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

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

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

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Komut şunları otomatik yapıyor: Python 3.11, uv paket yöneticisi ve Hermes'in kendisi. Sudo gerektirmiyor, her şey kullanıcı dizinine kuruluyor. İlk kurulum 20–30 dakika sürebilir — internete ve sistemine bağlı olarak değişir.

Kurulum tamamlandıktan sonra terminali kapat, yeni bir tane aç.

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, 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 setup gateway
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

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 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.

Kurulumu 20–30 dakika sürüyor. 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. Hermes'in 7/24 erişilebilir olmasını istiyorsan bir VPS veya cloud sunucu üzerine kurman gerekiyor. Digital Ocean, Hetzner veya benzeri bir hosting hizmetinde Linux sunucu kiralayıp aynı adımları uygulayabilirsin — aylık 5–10 dolar bandında seçenekler mevcut.