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

Nous Portal'ı seçeceksen: mindilot davet linkiyle ilk ay 20 dolar yerine 5 dolar. Abonelik hem Hermes Agent'ı hem Portal API'sini kapsıyor, ayda 22 dolarlık kredi veriyor, sonrasında 20 dolar/ay. Koşul: yeni müşteri ve yeni bireysel abonelik olman. Daveti aç — abone olursan bize API kredisi yazılıyor, sana giden indirim değişmiyor.

Hangi model seçilmeli? Kalite öncelikliyse Claude Sonnet, bütçe öncelikliyse DeepSeek V4. Gizlilik öncelikliyse yerel model — ama hangisinin senin makinende gerçekten döneceği ayrı bir mesele, hemen aşağıda anlatıyorum.

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.

Yerel model seçerken Hermes'in önerisine güvenme

Hermes'in son sürümlerinde işi kolaylaştıran bir özellik var: cihazının kapasitesine bakıp sana bir yerel model öneriyor, onaylayınca indirmeyi de kendisi yapıyor. Kulağa tam istediğin şey gibi geliyor. Burada dur.

Biz bu öneriye güvendik ve makine kilitlendi. 24 GB RAM'i, 6 GB VRAM'i olan bir dizüstüne 35 milyar parametrelik bir model önerdi. İndirdik, çalıştırdık, bilgisayar tamamen dondu — fare imleci bile kımıldamıyordu, yeniden başlatmaktan başka çare kalmadı.

Sebebi şu: bir model çalışırken diskte değil bellekte durur. 35 milyarlık bir modelin dört bite sıkıştırılmışⁱquantize edilmiş, yani ağırlıkları küçültülmüş hâli bile 20 GB'ın üstünde yer kaplar. Üstüne Windows'un kendi yediği 5-6 GB'ı ekleyince 24 GB'lık bir makinede çalışacak yer kalmaz; sistem takas dosyasınaⁱRAM dolunca diskin RAM yerine kullanılması düşer ve her şey durur.

Bir tuzak daha var. Bazı modeller MoEⁱuzman karışımı; modelin sadece bir bölümü her adımda çalışır mimarisiyle geliyor ve adlarında bunu taşıyor — "35B A3B" gibi. Buradaki 35 milyar modelin tamamı, 3 milyar ise her adımda hesaplanan kısım. Bu hızı artırır ama belleğe yüklenmesi gereken miktarı değiştirmez; modelin tamamı bellekte durur, sadece bir kısmı çalışır. "Aktif parametre küçükmüş, o zaman sığar" diye düşünme, sığmaz.

Doğru sıra şu: önce Hangi Yapay Zeka Çalışır? aracımıza gir, ekran kartını ve RAM'ini seç, sana hangi modellerin uyduğunu gör. Sonra Ayarlar → Sağlayıcılar → Yerel Modeller yolundan o modeli arat.

Burada bir ayrıntı işine yarayacak: Hermes kendi hâline bırakılırsa sığdırabildiği en yüksek kaliteli sürümü indiriyor. Aynı modelin bir alt sıkıştırma seviyesi çoğu zaman 4-5 GB daha küçüktür ve sıkışık bir makinede bu fark, kilitlenen model ile çalışan model arasındaki farktır. Katalogdan seçmek zorunda değilsin — Hermes doğrudan Hugging Face'te arama yapmana, hatta indirdiğin .gguf dosyasını elle kütüphaneye eklemene izin veriyor. Sıkışıksan bir alt seviyeyi kendin seç.

[mindi_yorum]
🟡 Hermes indirmeden önce VRAM'e, RAM'e ve diske bakıp her model satırında yeşil-amber-kırmızı bir bellek uyumluluk işareti gösteriyor. Bizim vakamızda bu gösterge kilitlenmeyi engellemedi — işarete değil, kendi rakamına güven.
🔵 Kaba kural: indireceğin dosya, RAM'inden en az 8 GB küçük olsun — işletim sistemi zaten o kadarını yiyor. 24 GB RAM'de 16 GB'lık dosya sınırda, 20 GB'lık dosya kilitler.

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.

Bot Mode: Tek Ajan Yerine Bir Ekip

Ağustos 2026'daki v0.20.3 sürümüyle masaüstü uygulamasına Bot Mode geldi. Önceden ayrı kurulan bir eklentiydi, artık uygulamanın içinde ve varsayılan olarak açık — güncellersen kendiliğinden geliyor:

hermes update

Güncelleme sonrası Sessions sekmesinin yanında bir Bots sekmesi beliriyor. Tek bir oturum listesi yerine, sol tarafta isimli botlardan oluşan bir liste görüyorsun; her satırda botun avatarı, son mesajı ve zaman damgası var. Bir bota tıkladığında doğrudan onun sohbetine düşüyorsun.

Bot aslında nedir?

Perde arkasında sihir yok: her bot bir Hermes profili. ~/.hermes/profiles/<isim>/ altında kendi ayarı, hafızası, skill'leri, kimlik bilgileri ve sohbet geçmişiyle duruyor. Bot Mode bu yapının üstüne bir arayüz koyuyor, yeni bir depolama katmanı ya da arka planda çalışan ayrı bir servis eklemiyor.

Pratikte anlamı şu: "araştırmacı" botuna verdiğin API anahtarı, "muhasebeci" botunun eline geçmiyor. Her botun hafızası kendine ait, biri diğerinin konuşmasını görmüyor.

Bot oluşturmak

New Agent ile isim, başlık ve açıklama giriyorsun — üç alan, bitti. Daha fazlasını istiyorsan Advanced bölümünü açıyorsun; orada mevcut bir profili klonlayabiliyor, bota belirli bir sağlayıcı ve model sabitleyebiliyor, kendi SOUL.md dosyanı yazabiliyor ve paketle gelen skill'leri devre dışı bırakabiliyorsun.

Model sabitlemek özellikle işe yarıyor: her işe aynı modeli koşturmak yerine, uzun araştırma yapan bota güçlü bir model, kısa özet çıkaran bota ucuz bir model verip faturayı bölüyorsun.

Bir bota sağ tıkladığında Edit Profile ile avatarını, başlığını ve açıklamasını sonradan değiştirebiliyor; Advanced bölümünden skill ve toolset seçimlerini, model sabitini ve SOUL.md'yi canlı düzenleyebiliyorsun. Duplicate ise botun tam kopyasını çıkarıyor — ayarı, skill'leri, SOUL.md'si, hafızası ve görünümüyle birlikte.

Avatar tarafında dört seçenek var: hazır geometrik yüzler (7 şekil × 10 renk, bot çalışırken gözleri kırpışıyor), kendi yüklediğin görsel, görsel üretme sağlayıcısı bağlıysa AI ile üretilmiş portre, ya da bot meşgulken avatarın yanında zıplayan piksel bir evcil hayvan.

Routines: her botun kendi takvimi

Bir önceki bölümdeki zamanlanmış görevlerin bot başına düşen hali. Sohbetin yanındaki Routines panelinde o bota özel tekrar eden işler tanımlıyorsun — "her sabah gelen kutumu özetle" gibi. Çalışma sonuçları o botun kendi sohbet geçmişine düşüyor, karışmıyor.

Arka planda bunlar sıradan Hermes cron görevleri; [bot:<isim>] <görev> biçiminde adlandırılıyorlar. Yani terminalden de görebiliyorsun:

hermes cron list

Botların birbirine mesaj atması

Her botun kalıcı bir Agent Inbox sohbeti var. Bir botla konuşurken başka birine iş devretmek istiyorsan mesajın içinde @ ile çağırıyorsun:

@arastirmaci şu rapordaki rakamları bir doğrula

Aktif bot mesajı devrediyor, cevabı bekliyor ve sana geri bildiriyor. Gelen mesaj karşı tarafta kimden geldiği belli olacak şekilde işaretleniyor ([Message from agent 'arastirmaci']), botun SOUL.md dosyası da nasıl cevap vereceğini ona öğretiyor. Perde arkasında bu bir CLI devri: hermes -p <bot> chat -c "Agent Inbox" -q "...".

Bilmen gereken iki sınır

Devir anlık değil. Karşıdaki bot mesajı bir sonraki çalışmasında görüyor — konuşmanın ortasındaki bir botu anında kesip araya girmek şimdilik mümkün değil, Nous Research bunu ileriye bırakmış.

Profil silme arayüzde bilinçli olarak yok. Bir botu tamamen kaldırmak istiyorsan terminalden:

hermes profile delete <isim>

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.