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 etkisiz 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 kurulum programı bağımlılıkları otomatik olarak yönetir. İhtiyacınız olanlar:
| Gereksinim | Ayrıntılar |
|---|---|
| İşletim Sistemi | Linux, macOS veya Windows with WSL2 |
| 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 Yüklenir?
Adım 1: Yükleyiciyi ç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 bağlı olarak 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-...
Modeller hakkındaki topluluk görüşü: Düşünme modu orta+ seviyesinde olan GPT 5.4 en popüler günlük sürücü. OpenRouter'daki Qwen 3.5 ücretsiz ve rutin otomasyon için yeterince yetenekli. Claude Opus en iyi kaliteyi üretir ancak önemli ölçüde daha pahalıdır — ve Anthropic ağır üçüncü taraf kullanımını kısıtlamaktadır.
Adım 3: Önemli özellikleri etkinleştirin.
Çoğu öğreticinin sizi başarısız kıldığı yer burası. Hermes yapılandırma dosyanızı açın ve bu iki ayarı etkinleştirin:
Bunlar olmadan, Hermes oturumlar arasında her şeyi unutur ve yeniden kullanılabilir beceriler asla 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ı hakkında haftalık rehberler yayınlıyoruz. Postanıza gelsin →
---İ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 bu başlangıç görevlerini deneyin:
Temel sohbet testi: "Bana neler konusunda yardımcı olabilirsin?" — LLM bağlantısının çalıştığını doğrular.
Web araması testi: "Nous Research hakkında en son haberleri ara ve 3 maddeyle özetle." — araç çağrısının çalıştığını doğrular.
Yetenek oluşturma testi: "2026'daki en iyi 5 AI ajan çerçevesini araştır, özelliklerini karşılaştır ve bir özet rapor yaz." — bu, 5+ araç çağrısını tetiklemeli, yani Hermes işini bitirdiğinde otomatik olarak bir yetenek dosyası oluşturacak. Dosyanın oluşturulduğunu doğrulamak için yetenekler dizininizi kontrol edin.
Bellek testi: Oturumu kapatın, yeni bir oturum başlatın ve "Geçen sefer ne konuştuk?" diye sorun. Kalıcı bellek çalışıyorsa, Hermes önceki konuşmayı hatırlayacaktır.
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şturmak ve bunu yapılandırmaya eklemek gerekir. İşte Discord örneği:
1. discord.com/developers/applications adresinde bir Discord bot oluşturun
2. Bot token'ını kopyalayın
3. Hermes yapılandırmanıza ekleyin:
4. Hermes'i yeniden başlatın. Botunuz Discord sunucunuzda görünür ve yanıt vermeye hazır hale gelir.
Aynı desen Telegram (BotFather token), Slack (app OAuth token) ve diğer platformlar için geçerlidir. Hermes v0.10.0, Microsoft Teams'i eklenti olarak gelen bir platform olarak ekledi ve toplamda 18+ mesajlaşma platformunu destekler.
Çoklu Kullanım Senaryoları İçin Profilleri Nasıl Ayarlarsınız?
Hermes v0.6.0 profilleri tanıttı — ayrı yapılandırma, bellek, beceriler ve ağ geçidi bağlantılarına sahip izole örnekler. Bu sayede Slack entegrasyonuyla bir "iş" profili ve Telegram ile bir "kişisel" profil çalıştırabilirsiniz, her biri kendi belleği ve öğrenilmiş becerileriyle.
En Yaygın Kurulum Hataları Nelerdir?
| Hata | Belirti | Çözüm |
|---|---|---|
| persistent_memory not enabled | Agent seanslar arasında her şeyi unutuyor | Set persistent_memory: true in config |
| skill_generation not enabled | Karmaşık görevlerden sonra beceri dosyaları oluşturulmuyor | Set skill_generation: true in config |
| Using low effort model settings | Çıktı kalitesi düşüş gibi hissediliyor | Set effort to high or xhigh |
| Running on a public VPS without hardening | Güvenlik açığı | Enable container isolation, read-only root |
| Not setting up checkpoint/rollback | Agent hatalarından kurtarılamıyor | Enable filesystem checkpoints in config |
AI ajanlarının nasıl çalıştığı ve Hermes'in ekosistemdeki yeri hakkında daha geniş bir anlayış için tam rehberimizi inceleyin. Herhangi bir AI ajanıyla etkileşimde daha iyi prompt'lar için ücretsiz Prompt Optimizer'ı deneyin.
---📬 Buna benzer daha fazla içerik mi istiyorsunuz? 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.