Hermes Agent Nedir? Nasıl Kurulur? (Mac, Linux, Windows)

Hermes Agent, Nous Research'ün geliştirdiği açık kaynaklı bir yapay zekâ ajanı. MIT lisansıyla GitHub'da yayımlanıyor ve terminalde, masaüstü uygulamasında, mesajlaşma uygulamalarında ve editörlerde çalışıyor. Onu sıradan bir sohbet botundan ayıran şey, yaptığı işten öğrenip tekrar kullanılabilir skill (yetenek) yazması ve oturumlar arasında hafızasını koruması.

Bu yazı serinin ilk bölümü: Hermes'in ne olduğunu, nasıl kurulduğunu ve ilk çalıştırmada neleri ayarlamanız gerektiğini anlatıyorum. İkinci bölümde Telegram, zamanlanmış görevler ve güvenli kullanımı ele alıyorum.

Bu yazı resmî dokümantasyona ve GitHub deposuna dayanır; kurulumu kendi makinemde denemedim. Komutları aşağıda olduğu gibi aktarıyorum, kaynaklar sonda. Sürüm numaraları kaynaklara göre değiştiği için kasıtlı olarak vermiyorum.

Hermes Agent nedir?

Hermes, bir dil modelinin etrafına kurulmuş bir ajan çerçevesi. Model değil; modeli seçen sizsiniz. Çerçeve şunları sağlıyor:

• Kalıcı hafıza. Oturumlar SQLite veritabanında (tam metin arama destekli) tutuluyor, böylece haftalar önceki bir konuşma geri çağrılabiliyor. Tercihleriniz memory.md ve user.md gibi dosyalarda saklanıyor.
• Skill sistemi. Ajan karmaşık bir işi bitirdikten sonra bundan yeniden kullanılabilir bir yordam çıkarabiliyor ve kullandıkça onu iyileştiriyor. Skill'ler ~/.hermes/skills/ altında duruyor ve agentskills.io biçimiyle uyumlu.
• Çoklu platform geçidi (gateway). Telegram, Discord, Slack, WhatsApp ve Signal üzerinden aynı ajanla konuşabiliyorsunuz; terminalde başlattığınız oturumu Telegram'dan sürdürebiliyorsunuz.
• Alt ajanlar. delegate_task aracıyla paralel iş akışları açabiliyor.
• MCP desteği. Model Context Protocol sunucularına bağlanabiliyor.
• Farklı çalışma ortamları. Yerel, Docker, SSH, Singularity, Modal, Daytona ve Vercel Sandbox.

Depo, OpenClaw'dan geçiş için hermes claw migrate komutunu da içeriyor; kişilikleri, hafızayı, skill'leri ve ayarları taşıyor.

Skill kavramını daha önce Agent Skill nedir yazısında ayrıntılı anlattım. Hermes bu fikrin en doğrudan uygulandığı araçlardan biri.

Gereksinimler

Resmî kurulum sayfasına göre tek sert gereksinim Git. Kurucu betik Python, Node.js ve gerekli araçları kendisi hallediyor. Desteklenen ortamlar:

Ortam	Durum
macOS	Masaüstü paketi yalnızca Apple Silicon; komut satırı kurulumu Intel'de de çalışır
Linux	Komut satırı kurulumu
Windows	PowerShell kurucusu ya da WSL2
Android	Termux paketi (aarch64)

Yerel modeli kendi donanımınızda çalıştıracaksanız ayrıca GPU belleği gerekir; bulut model kullanıyorsanız gerekmez. Bir üçüncü taraf rehberi ajanın modelde en az 64 bin token bağlam beklediğini belirtiyor; küçük bağlamlı bir model seçerseniz başlangıçta hata alabilirsiniz.

Kurulum

macOS, Linux ve WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc   # bash kullanıyorsanız ~/.bashrc
hermes

GitHub deposundaki alternatif adres de aynı betiği veriyor: https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh.

Windows

PowerShell'de:

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

Alternatif olarak WSL2 kurup Linux komutunu Ubuntu terminalinde çalıştırabilirsiniz. Üçüncü taraf rehberler yerel Windows kurulumunu erken aşama (beta) olarak niteliyor; sorun yaşarsanız WSL2 daha sağlam bir yol olur.

Masaüstü uygulaması

macOS ve Windows için indirilebilir masaüstü paketi de var; macOS sürümü yalnızca Apple Silicon destekliyor. Komut satırıyla başlayıp hermes desktop komutuyla yerel uygulamayı da açabilirsiniz.

Kurulumu kontrol edin

hermes doctor

Bu komut sistem sağlığını denetliyor. hermes: command not found hatası alırsanız terminali yeniden başlatın ya da kabuk dosyanızı source edin; kurucu komut satırı girişini ~/.local/bin/hermes altına koyuyor. Kurulumu sudo ile yapmayın.

İlk ayar

hermes setup

Kurulum sihirbazı model sağlayıcınızı soruyor. Seçenekler arasında Nous Portal, OpenRouter, Anthropic, OpenAI, Google Gemini ve Ollama gibi yerel modeller var. Sonradan değiştirmek için:

hermes model       # sağlayıcı ve model seçimi
hermes tools       # araçları aç/kapat
hermes config set FIRECRAWL_API_KEY anahtarınız

İki kural önemli:

1. Gizli bilgiler ~/.hermes/.env içinde, ayarlar config.yaml içinde durur. Dokümantasyon bir ayarı .env dosyasına koymamanızı açıkça söylüyor.
2. Ayarı hermes config set ile değiştirin, YAML'ı elle düzenlemeyin.

Dosyalar ~/.hermes/ altında toplanıyor: skills/, state.db (oturum deposu), sessions/ ve logs/ gibi.

Hangi modelle çalıştırmalı?

Hermes'in kendi ücreti yok; maliyet seçtiğiniz modelden geliyor.

• Bulut API (OpenRouter, Anthropic, OpenAI, Gemini): Kurulumu kolay, kullanım kadar ödersiniz.
• Nous Portal: Nous'un kendi aboneliği; hermes setup --portal ile giriş yapılıyor.
• Ollama ile yerel model: Ücretsiz ve çevrimdışı. Örnek akış: bir model indirin, ollama serve çalıştırın, sonra hermes model içinde "Custom endpoint" seçip http://localhost:11434/v1 adresini verin. Ollama'nın varsayılan bağlam penceresi küçük olduğu için OLLAMA_CONTEXT_LENGTH değişkeniyle büyütmeniz gerekebilir.

Yeni çıkan modellerin Hermes'te nasıl kullanılacağı konusunda, örneğin LongCat 2.5 Preview'ın kurulum rehberinde Hermes Agent için hazır bir yönerge olduğundan bahsetmiştim. Henüz erişime açılmamış Gemini 4 Argon gibi modeller için ise önce model kimliğinin yayımlanması gerekiyor.

İlk çalıştırma

hermes

Terminalde bir sohbet açılıyor. Küçük bir şeyle başlayın: "bulunduğum klasörde ne var?" gibi. Kullandığınız yardımcı komutlar:

hermes chat -q "tek seferlik soru"   # sohbet açmadan tek soru
hermes --continue                     # son oturumu sürdür
hermes --tui                          # terminal arayüzü
hermes update                         # güncelle

Tek bir çalışma için birden çok kişilik kurmak isterseniz hermes profile create work --clone gibi profiller de var; her profil kendi ~/.hermes/profiles/<ad>/ klasörünü kullanıyor.

Kimler için uygun?

• Terminalde rahat olanlar. Araç terminal merkezli; masaüstü uygulaması da var ama asıl güç komut satırında.
• Aynı ajanı telefondan da kullanmak isteyenler. Telegram geçidi bunun için.
• Tekrar eden işleri otomatikleştirmek isteyenler. Skill ve zamanlanmış görev bunun için.
• Kontrolü elinde tutmak isteyenler. Açık kaynak ve model seçimi sizde.

Basit bir tek seferlik kod sorusu için ağır gelebilir; bunun için doğrudan bir sohbet aracı yeter.

Sık Sorulan Sorular

Hermes Agent ücretsiz mi?

Yazılımın kendisi MIT lisanslı ve açık kaynak. Ödediğiniz şey kullandığınız modelin API ücreti; Ollama ile yerel model kullanırsanız ücretsiz çalışabilir.

Hermes Agent Windows'ta çalışır mı?

Evet. Resmî dokümantasyon PowerShell kurucusunu veriyor; WSL2 içinde Linux komutunu da kullanabilirsiniz.

Hermes Agent ile Claude Code arasındaki fark ne?

Hermes model bağımsız, hafızası ve skill üreten bir ajan çerçevesi; mesajlaşma uygulamalarından da çalışıyor. Claude Code Anthropic'in kendi kodlama ajanı. Araç karşılaştırması için vibe coding araç karşılaştırmasına bakın.

Hermes hangi modelleri destekliyor?

Nous Portal, OpenRouter, Anthropic, OpenAI, Google Gemini ve OpenAI uyumlu herhangi bir özel adres, Ollama dahil.

Kurulum ne kadar sürer?

Üçüncü taraf rehberler 2 ila 5 dakika diyor; bağlantı hızınıza göre değişir.

Kaynak

• Nous Research, hermes-agent (GitHub): özellikler, kurulum komutları, MIT lisansı, OpenClaw geçişi.
• Hermes Agent, Installation: gereksinimler, kurulum konumları, sorun giderme.
• Hermes Agent, resmî dokümantasyon: ~/.hermes yapısı, yapılandırma kuralları, sağlayıcılar.
• DataCamp, Nous Research Hermes Agent: Setup and Tutorial Guide: hafıza ve skill mimarisi, Ollama kurulumu, profiller.
• Hermes Atlas, How to Install Hermes Agent: işletim sistemi notları ve sorun giderme (üçüncü taraf).
• NxCode, Hermes Agent Tutorial: bağlam penceresi gereksinimi (üçüncü taraf).