Hermes Agent Hızlı Başlangıç: Kurulumdan İlk Adımlara

Hermes’in neden dikkat çektiği

Daha önce yeni bir AI aracı yükleyip, binary’nin PATH‘inize düştüğünü izlediyseniz ve yine de teknik olarak mevcut ama pratikte işe yaramaz bir şeyle karşılaştıysanız, bu Hermes Agent hızlı başlangıç kılavuzunun çözdüğü sorunu zaten anlıyorsunuzdur. Tamamlanmış bir kurulum yalnızca dosyaların kopyalandığını kanıtlar. Agent’ın bir repo’yu inceleyebileceğini, gerçek bir modelle konuşabileceğini, araçları güvenli şekilde kullanabileceğini veya çalışmayı daha sonra yeniden açabileceğini kanıtlamaz.

Hermes’in neden dikkat çektiği işte bu yüzdendir. Düzgün çalıştığında, “terminalde ChatGPT” gibi hissettirmeyi bırakır ve operasyonel bir agent gibi davranmaya başlar. Dosyaları inceleyebilir, terminal araçlarını kullanabilir, bir çalışma alanı içinde kalabilir ve her prompt sıfırdan başlıyormuş gibi davranmak yerine oturumu ileriye taşıyabilir.

Bu, gerçek görevlerde yardım isteyen geliştiriciler, kendi sunucusunu yönetenler ve terminal odaklı kullanıcılar için iyi bir seçenek haline getirir: bir kod tabanını özetlemek, kişisel bir makinedeki repo’yu kontrol etmek veya daha büyük bir otomasyon yığınına geçmeden AlexHost, AvaHost ya da başka bir sağlayıcıdan küçük bir VPS üzerinde çalıştırmak gibi. Bu kılavuzun sonunda Hermes kurulu, yapılandırılmış, güvenli bir ilk görevde test edilmiş ve başarıyla devam ettirilmiş olacak.

Hermes nedir — ve bu kılavuz size gerçekte ne konusunda yardımcı olacak

Herhangi bir komut çalıştırmadan önce üç terimi birbirinden ayırın. İlk çalıştırmadaki karışıklıkların çoğu, bunları “AI” hakkında belirsiz tek bir fikre indirgemekten kaynaklanır.

Aşağıdaki tablo, bu eğitim için çalışan zihinsel modeli sunar:

Bu makale yalnızca tek bir başarı durumunu hedeflemektedir: başlatabileceğiniz, test edebileceğiniz ve devam ettirebileceğiniz tek bir güvenli, çalışan Hermes oturumu. Bu bir üretim dağıtım kılavuzu değildir. Tam bir özellik turu da değildir. “Hermes makinemde çalışıyor ve bunu kanıtlayabilirim” noktasına ulaşmanın en kısa güvenilir yoludur.

📝 Not: Hermes’i kurmak, Hermes’i yapılandırmakla aynı şey değildir. Binary mevcut olabilir ve hermes model komutunu çalıştırıp bir provider ve modele bağlayana kadar kullanılamaz durumda kalabilir.

Resmi belgelerin ayrıca hermes setup sunduğunu fark edebilirsiniz. Bu geçerlidir, ancak bu kılavuz kurulumu hermes model‘den kasıtlı olarak ayırır; böylece ilk çalıştırmada başarı veya başarısızlığın tam olarak nerede gerçekleştiğini görebilirsiniz. Tekrarlanabilirlik için klasik CLI’yi ön planda tutuyoruz; hermes –tui mevcut olsa da aynı temel oturumları kullanır. Bu hızlı başlangıç kılavuzunun kapsamı dışında kalanlar: gateway kurulumu, cron, MCP, yerel model ağı, çoklu provider yönlendirmesi ve üretim güçlendirmesi.

Hermes’e shell erişimi vermeden önce güvenlik kuralları

Terminal erişimine sahip herhangi bir agent’ı test etmeden önce, nerede yanılmasına izin verileceğine karar verin. Bu makale için bu, üretim dışı bir makine, bir VM, tek kullanımlık bir repo veya en azından yanlışlıkla verilen bir komutun gününüzü mahvetmeyeceği düşük riskli bir çalışma alanı anlamına gelir.

⚠️ Uyarı: Bu hızlı başlangıç kılavuzunun tamamı boyunca onayları varsayılan güvenli modda tutun ve –yolo kullanmayın. Hermes riskli komutlardan önce sorar; bu bir güvenlik özelliğidir, gereksiz bir sürtüşme değil.

Devam etmeden önce bu hızlı kontrol listesini kullanın:

• Düşük riskli bir makine veya çalışma alanında başlayın.
• Onay prompt’larını etkin tutun.
• İlk test için kişisel üretim repo’larından kaçının.
• Kanıt görevinin salt okunur kalmasını bekleyin.
• Docker ve SSH terminal backend’lerini ilk gün gereksinimleri olarak değil, sonraki güçlendirme adımları olarak değerlendirin.

Bu kılavuzdaki ilk gerçek kanıt görevi ~/.hermes/hermes-agent içinde kalır; bu, demoyu hassas projelerden uzak tutarken Hermes ile ilgili tutar. Temel CLI akışı kararlı hale geldiğinde, Docker veya uzak backend’lerle daha güçlü izolasyona geçebilirsiniz. İlk saat için güvenli ve kontrol edilebilir olmak, hırslı olmaktan daha iyidir.

Kurulumdan önce: ön koşullar, desteklenen yollar ve bir WSL2 uyarısı

Ana akım kullanıcılar için desteklenen senaryo basittir: Linux, macOS ve WSL2 önce önem verilmesi gereken yollardır. Yerel Windows mevcuttur, ancak hâlâ erken beta aşamasındadır; dolayısıyla Windows kullanıyorsanız pratik öneri yine WSL2’dir.

Ubuntu 24.04 veya WSL2’de, git ve curl‘ün mevcut olduğundan emin olarak başlayın:

İkinci satır, distro dizenizi ve her iki araç için çalışan sürüm çıktısını döndürüyorsa, temel ön koşullarınız hazır demektir. macOS’ta eşdeğer kontrol genellikle aynı Hermes yükleyicisini kullanmadan önce git –version ve curl –version‘ı doğrulamaktan ibarettir.

📝 Not: Yerel Windows hâlâ erken beta aşamasında olduğundan, Windows kullanıyorsanız WSL2’yi tercih edin.
💡 İpucu: WSL2’de, daha yavaş Git işlemlerinden ve garip dosya izni davranışından kaçınmak için Hermes’i ve çalışma repo’larınızı /mnt/c yerine ~ altında tutun.

İyi haber şu ki Hermes, önce devasa bir bağımlılık yığınını manuel olarak oluşturmanızı gerektirmez. Resmi git yükleyicisi sizin için uv, Python 3.11, Node.js 22, ripgrep ve ffmpeg‘i yönetir. Kurulum sihirbazı başlamadan önce hazır bulundurmanız gereken şey bir provider hesabı veya en azından özel bir endpoint için test edilmiş bir plandır. Ayrıca en az 64K bağlam içeren bir model seçin: daha küçük bağlam pencereleri, agent dosya bağlamını, araç çıktısını ve çok adımlı talimatları bir arada taşımaya başladığında bozulma eğilimi gösterir.

Hermes Agent’ı resmi tek satırlık yöntemle kurun

Ön koşullar tamamlandıktan sonra, resmi yükleyiciyi tam olarak belgelendiği şekilde çalıştırın:

Bu artık yalnızca basit bir kurulum adımı değildir. Hermes platformu algılar, ihtiyaç duyduğu bağımlılıkları hazırlar ve ardından hemen ilk çalıştırma kurulum akışına devam eder. Yukarıdaki örnekte yükleyici Linux’u algılar, uv‘yi kontrol eder, gerektiğinde Python 3.11’i kurar, tarayıcı araçları için Node.js 22’yi hazırlar ve Hermes komut ortamını oluşturur.

Kurulumunuz root olarak gerçekleştirilirse, /usr/local/bin/hermes, /usr/local/lib/hermes-agent ve /root/.hermes/ gibi yollar görebilirsiniz. Normal bir kullanıcı kurulumunda, aynı yapıyı kendi ana dizininizin altında bekleyin.

Önemli ayrıntı şudur: tek satırlık yükleyici artık doğrudan kurulum sihirbazına geçer. Başka bir deyişle, kurulum ve ilk çalıştırma yapılandırması tek bir sürekli akıştır. Paket kurulumunun sonunu bitiş çizgisi olarak değerlendirmeyin; çünkü bu kurulum sihirbazı tamamlanana kadar Hermes gerçekten kullanışlı değildir.

İlk karar, çıkarım provider’ıdır. Bu çalıştırmada OpenRouter seçilmiştir; bu, tek bir provider hesabı üzerinden geniş bir model kataloğuna erişim sağladığı için pratik bir ilk seçimdir. Zaten farklı bir desteklenen provider kullanıyorsanız, onu seçin.

Provider seçildikten sonra Hermes, eşleşen API anahtarını ister. Bu örnekte bu, OPENROUTER_API_KEY anlamına gelir. Anahtarı yapıştırın, Enter’a basın ve Hermes onu ileride kullanmak üzere saklar.

Bu adımı atlarsanız Hermes kurulumu tamamlayabilir, ancak gerçek bir agent oturumu için henüz hazır olmayacaktır. Provider’ı daha sonra geri gelip yapılandırmanız gerekir.

Anahtar kaydedildikten sonra sihirbaz model seçimine geçer. Bu çalıştırmada seçilen model deepseek/deepseek-v4-pro‘dur. Bu geçerli somut bir örnektir, ancak tek yolunuz değildir: sihirbaz ayrıca özel bir model adı girmenize veya mevcut bir kurulumda setup’ı yeniden çalıştırıyorsanız mevcut modeli korumak için atlamanıza olanak tanır.

İlk çalıştırma için pratik kural basittir: erişebildiğinizi zaten bildiğiniz bir modeli seçin ve gerçek agent çalışması için yeterli bağlama sahip olduğundan emin olun. Hermes, en az 64K bağlam penceresi sunan modellerle çok daha güvenilirdir. Daha küçük bağlam pencereleri küçük bir testte iyi görünebilir, ancak araç çıktısı, dosya bağlamı ve çok adımlı talimatlar birikmeye başladığında bozulabilir.

Bu seçimi daha sonra değiştirmek isterseniz, hermes model hâlâ hiçbir şeyi yeniden yüklemeden provider ve model seçimini yeniden çalıştırmanın en hızlı yoludur.

Ardından Hermes, daha geniş kurulumun ne kadarını şu anda yapmak istediğinizi sorar. Bu hızlı başlangıç kılavuzu için önerilen seçenek doğru olandır: hızlı kurulum.

Bu, makaleyi yük taşıyan yola odaklı tutar: provider, model ve Hermes’i kullanılabilir kılmak için gereken minimum çevre seçimleri.

Bir sonraki ekran terminal backend’ini sorar. İlk çalıştırma için mevcut yerel backend’i koruyun; böylece Hermes doğrudan bu makinede çalışır. Docker, SSH, Modal ve diğer backend’ler daha sonra kullanışlıdır, ancak temel CLI iş akışının çalıştığını henüz doğrulamadan önce karmaşıklık eklerler.

Hermes ardından mesajlaşma platformu kurulumu sunar. Bu hızlı başlangıç kılavuzu için atlayın. Bu, kılavuzu temel CLI agent akışına odaklı tutar ve daha sonra hermes setup gateway ile Telegram, Discord veya başka bir mesajlaşma yolu ekleyebilirsiniz.

Sihirbaz tamamlandıktan sonra Hermes, önemli dosyaları nerede sakladığını gösterir.

Hatırlanması gereken ana ayrım basittir: config.yaml gizli olmayan ayarları tutar, .env API anahtarlarını ve diğer gizli bilgileri tutar, veri dizinleri ise oturumları, günlükleri ve ilgili çalışma zamanı durumunu tutar. Bu ekran görüntüsünde kurulum root olarak yapıldığından yollar /root/.hermes/ altındadır. Normal bir kullanıcı kurulumunda, bu yolları ~/.hermes/ olarak okuyun.

Hermes ardından ilk kullanmaya hazır özeti yazdırır; en olası kullanacağınız komutlar dahil.

Bu noktada Hermes hem kurulu hem de yapılandırılmıştır. Bir sonraki adım, ilk gerçek göreve geçmeden önce ortamın sağlıklı olduğunu doğrulamaktır:

hermes doctor, temel bilgileri doğrulamalıdır: aktif güvenlik uyarısı yok, çalışan bir Python ortamı ve gerekli paketler mevcut. Devam etmeden önce istediğiniz temiz başarı sinyali budur.

Yeni bir shell’de hermes henüz görünmüyorsa, devam etmeden önce shell’inizi yeniden yükleyin ve komut yolunu doğrulayın. Bash’te bu genellikle source ~/.bashrc; Zsh’te source ~/.zshrc anlamına gelir. Gerekirse başlatıcıyı command -v hermes ile doğrulayın.

Doctor geçtikten sonra kurulum yalnızca tamamlanmış değil — Hermes artık gerçekten kullanıma hazırdır.

İlk güvenli agent görevinizi çalıştırın

Hermes artık kurulu, yapılandırılmış ve hermes doctor tarafından kontrol edilmiş olduğundan, ilk gerçek gösterime hazırsınız. En güvenli yüksek sinyalli ilk çalışma alanı, Hermes’in kendi ana dizinidir. Bu çalıştırmada kurulum root olarak yapıldığından, bu dizin /root/.hermes‘tir. Normal bir kullanıcı kurulumunda, aynı yer ~/.hermes olacaktır.

O dizine geçin, nerede olduğunuzu doğrulayın ve ardından Hermes’i başlatın:

Bu, iyi bir ilk çalışma alanıdır çünkü zaten mevcuttur, az önce kurduğunuz araçla doğrudan ilgilidir ve kişisel veya üretim repo’suna agent bırakmakla karşılaştırıldığında düşük risklidir. Başlangıç ekranı da kendi başına yararlı bir akıl sağlığı kontrolüdür: Hermes’in doğru şekilde başladığını, alt bilgideki aktif modeli ve agent’ın mevcut araçlarını ve paketlenmiş becerilerini zaten görebildiğini gösterir.

Daha yeni arayüzü tercih ediyorsanız, hermes –tui hâlâ mevcuttur, ancak bu kılavuz adım adım yeniden üretmesi daha kolay olduğu ve her iki arayüz de aynı oturumları paylaştığı için klasik CLI’yi ön planda tutar.

Hermes açıldığında, mevcut çalışma alanını incelemesini ve giriş noktasını belirlemesini isteyen basit, salt okunur bir prompt verin. Bu örnekte, kurulum root olarak gerçekleştirildiğinden prompt açıkça /root/.hermes‘i hedefler. Normal bir kullanıcı kurulumunda, kendi ~/.hermes dizininize yönlendirin.

Aşağıdaki prompt’u kullanın:

Summarize this repo in 5 bullets and tell me what the main entrypoint is: ~/.hermes

İstediğiniz ilk görev tam olarak budur: güvenli, gözlemlenebilir ve doğrulaması kolay. Yukarıdaki ekran görüntüsünde Hermes yalnızca tahmin etmez. config.yaml, SOUL.md ve .install_method gibi somut dosyaları okumaya başlar, Hermes ile ilgili dosyaları arar ve kurulu başlatıcı yolunu inceler. Bu görünür araç etkinliği, Hermes’in tek seferlik bir sohbet kutusu yerine bir agent gibi davrandığının gerçek kanıtıdır.

Sağlıklı bir sonuç, çalışma alanına bağlı somut bir özet ve doğrulanabilir bir giriş noktasıyla geri dönmelidir. Bu çalıştırmada Hermes, /usr/local/bin/hermes‘teki kurulu komut sarmalayıcısını tanımlar, Python CLI giriş noktasına yönlendirdiğini açıklar ve çevreleyen Hermes ortamını beş madde halinde özetler.

Aranacak başarı sinyali budur. Yanıt spesifiktir, Hermes’in gerçekten incelediği dosyalara dayalıdır ve diskte zaten görebildiklerinizle karşılaştırarak kolayca doğrulanabilir. Sonucu sihir olarak değerlendirmeyin — özeti görünür dosyalar ve dizin düzeniyle karşılaştırın. İlk demo için güvenli ve doğrulanabilir olmak, gösterişli olmaktan çok daha iyidir.

Oturumu devam ettirin ve kurulumun gerçekten çalıştığını doğrulayın

Hızlı başlangıç kılavuzu, Hermes bir kez yanıt verdiğinde tamamlanmış değildir. Oturumun devam ettirilebildiğini doğruladığınızda tamamlanmış olur.

Aşağıdaki devam ettirme komutunu kullanın; -c, aynı işlem için kısa formdur:

Beklenen sonuç, Hermes’in en son oturumu yeniden açması veya az önce çalıştırdığınız göreve açıkça ait olan bir özet sunmasıdır. Bu önemlidir çünkü Hermes’in tek kullanımlık bir sohbet gibi davranmadığını kanıtlar. Geri dönebileceğiniz kalıcı bir çalışma oturumu tutar.

Devam etmeden önce bu kompakt başarı kontrol listesini kullanın:

• Hermes kuruldu ve doğrulandı
• Provider yapılandırıldı
• İlk yanıt temiz
• İlk repo görevi tamamlandı
• Oturum başarıyla devam ettirildi

Devam ettirme çalışmazsa, önce aynı profili kullandığınızdan emin olun, ardından hermes sessions list ile mevcut oturumları kontrol edin. hermes –continue çalıştığında, bu Hermes Agent eğitiminin oluşturmayı amaçladığı tam temel çizgiye sahip olursunuz.

Temel iş akışı çalıştıktan sonra ne deneyebilirsiniz

Temel sohbet kararlı hale geldiğinde, bir seferde yalnızca bir yeni katman ekleyin.

💡 İpucu: Her gelişmiş özelliği hemen etkinleştirme dürtüsüne karşı koyun. Önce tek bir temiz iş akışını kararlı hale getirin, ardından kasıtlı olarak genişletin.

İşte mantıklı sonraki adımların kısa menüsü:

• Aynı oturum modeli üzerinde daha yeni terminal arayüzünü istiyorsanız hermes –tui‘yi deneyin.
• Temelleri manuel olarak anladıktan sonra daha geniş kurulum sihirbazını istiyorsanız hermes setup‘ı çalıştırın.
• Bir sonraki hedefiniz mesajlaşma platformu entegrasyonuysa hermes gateway setup‘ı keşfedin.
• Kontrollü yetenek genişletmesi istediğinizde hermes tools ve hermes skills‘i inceleyin.
• Agent daha yüksek riskli sistemlere dokunmaya başlayacaksa Docker veya SSH terminal backend’ine geçin.
• Barındırılan yol zaten çalışır durumdayken özel provider’lar ve yerel model endpoint’leri için resmi belgeleri kullanın.

Gerçek kullanım için takip fikirleri istiyorsanız, araştırılacak birkaç iyi fikir şunlardır: kod tabanı oryantasyon notları, değişiklik günlüğü taslağı hazırlama, güvenli yeniden düzenleme planlaması, yapılandırma dosyası açıklaması, pull request inceleme özetleri, VPS bakım kontrol listeleri, dağıtım runbook taslağı hazırlama, günlük önceliklendirme prompt’ları ve belgeleme boşluğu bulma.

Daha derin yollar için, bu hızlı başlangıç kılavuzunu ikinci bir makaleye uzatmak yerine dışarıya bağlantı verin: hızlı başlangıç, kurulum belgeleri, CLI kılavuzu ve güvenlik kılavuzu doğru sonraki duraklar.

Artık güvenli çalışan bir Hermes hızlı başlangıç kılavuzuna sahipsiniz

Önemli kilometre taşı, Hermes’in kurulmuş olması değildir. Önemli kilometre taşı, Hermes’in kullanışlı hale gelmesidir. Artık doğrulanmış bir temel çizginiz var: binary mevcut, provider yapılandırılmış, ilk yanıt çalıştı, ilk güvenli görev tamamlandı ve oturum ardından devam ettirildi.

Durulacak ve kazanımı kutlanacak doğru yer burasıdır. Onayları açık tutun, bir seferde bir katman genişletin ve agent daha yüksek riskli işler yapmaya başladığında daha güçlü izolasyona geçin. Hermes’i sonunda kişisel bir iş istasyonunda, bir lab kutusunda veya AlexHost, AvaHost ya da başka bir yerden VPS üzerinde çalıştırırsanız, kural aynı kalır: güveni küçük adımlarla kazanın.