Hermes Agent tek bir komutla kurulur ve Linux, macOS veya WSL2 üzerinde çalışır. Ama kurulum kolay kısım — "çalışıyor" ile "zamanla gerçekten gelişiyor" arasındaki fark yapılandırmada. Hermes'i yetersiz bulan çoğu kullanıcı, onu farklı kılan özellikleri hiç etkinleştirmemiş.
Bu rehber, ilk kurulumdan ilk otomatik görevinize kadar her şeyi kapsar; çoğu eğitimde atlanan yapılandırma adımlarıyla.
Ana Çıkarım
Kurulum 2 dakika sürer. Yapılandırma 15. Çoğu kişinin atladığı kritik adımlar: config dosyasında persistent_memory ve skill_generation'ı etkinleştirmek. Bunlar olmadan, Hermes herhangi bir tek oturum ajanından farksız davranır.
Kurmadan Önce Neye İhtiyacınız Var?
Neredeyse hiçbir şeye. Hermes'in kurucusu bağımlılıkları otomatik yönetir. Şunlara ihtiyacınız var:
| Gereksinim | Detaylar |
|---|---|
| İşletim Sistemi | Linux, macOS veya WSL2 ile Windows |
| LLM API Key | En az biri: Anthropic (Claude), OpenAI (GPT), Google (Gemini) veya OpenRouter |
| Donanım | Herhangi bir modern makine. Sürekli açık için: $5-10/ay VPS gayet iyi çalışır |
| Terminal erişimi | Temel komut satırı bilgisi |
Hermes Agent Nasıl Kurulur?
Adım 1: Kurucuyu çalıştırın.
Bu, her şeyi indirir ve kurar — Node.js, Python bağımlılıkları, SQLite ve Hermes çalışma zamanı. Bağlantınıza göre 1-3 dakika sürer.
Adım 2: LLM sağlayıcınızı yapılandırın.
Kurulumdan sonra Hermes hangi LLM sağlayıcısını kullanacağınızı sorar. En yaygın seçenekler:
📋 SAĞLAYICI YAPILANDIRMA ÖRNEKLERİ
# Claude için (en iyi kalite, daha yüksek maliyet) provider: anthropic model: claude-sonnet-4-20250514 api_key: sk-ant-... # GPT için (iyi denge) provider: openai model: gpt-5.4 api_key: sk-... # Bütçe kurulumları için (OpenRouter üzerinden ücretsiz) provider: openrouter model: qwen/qwen-3.5 api_key: sk-or-...
Topluluk modelleri konusunda uzlaşıyor: Orta+ düşünme modu açık GPT 5.4 en popüler günlük sürücü. OpenRouter'da Qwen 3.5 ücretsiz ve rutin otomasyon için yeterince yetenekli. Claude Opus en iyi kaliteyi üretir ama önemli ölçüde daha pahalı — ve Anthropic ağır üçüncü taraf kullanımını kısıtlıyor.
Adım 3: Önemli özellikleri etkinleştirin.
Çoğu eğitim burada başarısız olur. Hermes config dosyanızı açın ve şu iki ayarı etkinleştirin:
Bunlar olmadan, Hermes oturumlar arasında her şeyi unutur ve yeniden kullanılabilir beceriler hiç oluşturmaz. Sadece başka bir sohbet botu kabuğu olur. Bunlar etkinleştirildiğinde, her karmaşık görev (5+ araç çağrısı) otomatik olarak bir beceri dosyası oluşturur ve tüm konuşmalar oturumlar arasında aranabilir hale gelir.
---📬 Bundan değer mi alıyorsunuz? AI araçları ve iş akışları üzerine haftalık rehberler yayınlıyoruz. Posta kutunuza alsın →
---İlk Görevinizi Nasıl Çalıştırırsınız?
Hermes'i terminalinizde başlatın:
Şimdi etkileşimli bir oturumdasınız. Her şeyin çalıştığını doğrulamak için şu başlangıç görevlerini deneyin:
Temel sohbet testi: "Bana ne konuda yardım edebilirsin?" — LLM bağlantısının çalıştığını doğrular.
Web arama testi: "Nous Research hakkında en son haberleri ara ve 3 maddeyle özetle." — Araç çağrısının çalıştığını doğrular.
Beceri oluşturma testi: "2026'daki en iyi 5 AI ajan çerçevesini araştır, özelliklerini karşılaştır ve özet rapor yaz." — Bu 5+ araç çağrısını tetiklemeli, yani Hermes bittiğinde otomatik olarak bir beceri dosyası oluşturur. Dosyanın oluşturulduğunu doğrulamak için beceriler dizininizi kontrol edin.
Bellek testi: Oturumu kapatın, yeni bir tane başlatın ve "Geçen sefer ne konuştuk?" diye sorun. Kalıcı bellek çalışıyorsa, Hermes önceki konuşmayı hatırlar.
Mesajlaşma Platformlarını Nasıl Bağlarsınız?
Hermes Discord, Telegram, Slack, Microsoft Teams ve daha fazlasını destekler. Her platform için bir bot token oluşturup config'e eklemeniz gerekir. Discord örneği:
1. discord.com/developers/applications adresinde Discord botu oluşturun
2. Bot token'ını kopyalayın
3. Hermes config'inize ekleyin:
4. Hermes'i yeniden başlatın. Botunuz Discord sunucunuzda belirir, yanıt vermeye hazır.
Aynı desen Telegram (BotFather token), Slack (app OAuth token) ve diğer platformlar için geçerli. Hermes v0.10.0 Microsoft Teams'i eklenti olarak gönderdi ve toplam 18+ mesajlaşma platformunu destekliyor.
Çoklu Kullanım Senaryoları İçin Profil Nasıl Ayarlanır?
Hermes v0.6.0 profilleri tanıttı — ayrı yapılandırma, bellek, beceriler ve gateway bağlantılarıyla izole örnekler. Bu sayede Slack entegrasyonuyla "iş" profili ve Telegram'lı "kişisel" profil çalıştırabilirsiniz; her birinin kendi belleği ve öğrendiği becerileriyle.
En Yaygın Kurulum Hataları Nelerdir?
| Hata | Belirti | Çözüm |
|---|---|---|
| persistent_memory etkin değil | Ajan oturumlar arasında her şeyi unutur | Config'de persistent_memory: true yapın |
| skill_generation etkin değil | Karmaşık görevlerden sonra beceri dosyası oluşmaz | Config'de skill_generation: true yapın |
| Düşük çaba modeli ayarları kullanmak | Çıktı kalitesi düşüş gibi hissettirir | Çabayı high veya xhigh yapın |
| Güvenlik sertleştirmesi olmadan herkese açık VPS'te çalıştırmak | Güvenlik açığı | Konteyner izolasyonunu etkinleştirin, salt okunur root |
| Checkpoint/rollback ayarlamamak | Ajan hatalarından kurtaramazsınız | Config'de dosya sistemi checkpoint'lerini etkinleştirin |
AI ajanlarının nasıl çalıştığı ve Hermes'in ekosistemdeki yeri hakkında daha geniş anlayış için tam rehberimizi görün. Herhangi bir AI ajanıyla etkileşimde daha iyi prompt'lar için ücretsiz Prompt Optimizer'ı deneyin.
---📬 Bundan daha fazlasını ister misiniz? Pratik AI kurulum rehberleri, haftalık. Ücretsiz abone olun →
---Sıkça Sorulan Sorular
Kurulum ne kadar sürer?
Kurulum 2 dakika. Temel LLM yapılandırması 5 dakika. Bellek, beceriler ve mesajlaşma entegrasyonlarını etkinleştirmek 10-15 dakika daha alır. Toplam: Tam işlevsel bir ajana 30 dakikadan az.
Hermes Agent'ı Raspberry Pi'da çalıştırabilir miyim?
Teknik olarak evet (Linux'ta çalışır), ama performans sınırlı olacak. DigitalOcean veya Hetzner'dan $5-10/ay VPS daha iyi performans ve sürekli açık yeteneği sağlar.
LLM sağlayıcısını sonradan değiştirirsem ne olur?
Değiştirmek config değişikliği — kod değişikliği gerekmez. Belleğiniz, becerileriniz ve konuşma geçmişiniz korunur. Sadece LLM yanıtları yeni modele göre kalite/tarzda değişir.
Docker'a ihtiyacım var mı?
Hayır. Standart kurulum Docker gerektirmez. Docker isteğe bağlıdır ve sadece güvenlik için konteyner izolasyonu istediğiniz üretim dağıtımları için önerilir.
Açıklama: Bu makaledeki bazı bağlantılar ortaklık bağlantılarıdır. Sadece kişisel olarak test edip düzenli kullandığımız araçları öneririz. Tam açıklama politikasımızı görün.