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

Hermes’in neden dikkate alınmaya değer olduğu

Daha önce yeni bir AI aracı yüklediyseniz, binary’nin PATH‘inize yerleştiğini 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.

İşte bu yüzden Hermes dikkate alınmaya değer. 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 da onu gerçek görevlerde yardım isteyen geliştiriciler, kendi sunucusunu yönetenler ve terminal odaklı kullanıcılar için uygun bir seçenek haline getirir: bir kod tabanını özetlemek, kişisel bir makinedeki bir repo’yu kontrol etmek veya daha büyük bir otomasyon yığınına doğrudan atlamadan AlexHost’tan 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ığın büyük çoğunluğu, bunları “AI” hakkında tek bir belirsiz fikir olarak birleştirmekten kaynaklanır.

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

Bu makale yalnızca tek bir başarı durumunu hedefliyor: 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ğil. Tam bir özellik turu da değil. “Hermes makinemde çalışıyor ve bunu kanıtlayabilirim”e giden en kısa güvenilir yol.

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

Resmi dokümanların ayrıca hermes setup sunduğunu fark edebilirsiniz. Bu geçerli bir seçenektir, ancak bu kılavuz kasıtlı olarak kurulumu hermes model‘den 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. Ayrıca tekrarlanabilirlik için klasik CLI’ı ö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 sertleştirmesi.

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

Terminal erişimiyle 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ılavuzu 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 sertleştirme adımları olarak ele alın.

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. Native 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 yerli yerindedir. macOS’ta eşdeğer kontrol genellikle aynı Hermes yükleyicisini kullanmadan önce git –version ve curl –version‘ı doğrulamaktan ibarettir.

📝 Not: Native Windows hâlâ erken beta yolundadır; bu nedenle 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 bir araya getirmenizi gerektirmiyor. Resmi git yükleyicisi uv, Python 3.11, Node.js 22, ripgrep ve ffmpeg‘i sizin için halleder. 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 penceresi olan 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 çökme eğilimi gösterir.

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

Ö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ından fazlasıdır. 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 yükler, 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, kendi ana dizininiz altında aynı yapıyı bekleyin.

Önemli ayrıntı şudur: tek satırlık yükleyici artık doğrudan kurulum sihirbazına geçiş yapıyor. 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ü Hermes bu kurulum sihirbazı tamamlanana kadar 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 gelecekte 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 kurulumu yeniden çalıştırıyorsanız atlamanıza ve mevcut modeli korumanı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 çökebilir.

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ıç için önerilen seçenek doğru olanıdı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.

Sonraki ekran terminal backend’i 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ıç için atlayın. Bu, kılavuzu temel CLI agent akışına odaklı tutar ve Telegram, Discord veya başka bir mesajlaşma yolunu daha sonra hermes setup gateway ile 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 sırları tutar, veri dizinleri ise oturumları, günlükleri ve ilgili çalışma zamanı durumunu tutar. Bu ekran görüntüsünde yollar /root/.hermes/ altındadır çünkü kurulum root olarak yapılmıştır. Normal bir kullanıcı kurulumunda, bu yolları ~/.hermes/ olarak okuyun.

Hermes ardından, ilk kullanacağınız komutlar dahil kısa hazır özeti yazdırır.

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

hermes doctor temelleri 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.

hermes yeni bir shell’de 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’de 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ış olmakla kalmaz — Hermes artık gerçekten kullanıma hazırdır.

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

Hermes artık kurulmuş, yapılandırılmış ve hermes doctor tarafından kontrol edilmiş durumdayken ilk gerçek gösterime hazırsınız. En güvenli yüksek sinyalli ilk çalışma alanı Hermes ana dizininin kendisidir. Bu çalıştırmada kurulum root olarak yapıldı, dolayısıyla 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ün de aynı oturumları paylaştığı için klasik CLI’ı ö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 prompt, kurulum root olarak yapıldığı için açıkça /root/.hermes‘i hedefler. Normal bir kullanıcı kurulumunda, bunun yerine kendi ~/.hermes dizininizi işaret edin.

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

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

Bu tam olarak istediğiniz türde bir ilk görevdir: 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 kontrol edilebilir 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, bunun Python CLI giriş noktasına yönlendirdiğini açıklar ve çevreleyen Hermes ortamını beş maddede özetler.

Aranacak başarı sinyali budur. Yanıt spesifiktir, Hermes’in gerçekten incelediği dosyalara dayalıdır ve diskte zaten görebileceklerinizle 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ıç, 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 tutuyor.

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, aynı anda 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şlemesi 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ışıyorken özel provider’lar ve yerel model endpoint’leri için resmi dokümanları kullanın.

Gerçek kullanım için takip fikirleri istiyorsanız, araştırmanız için birkaç iyi öneri: kod tabanı katılım 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 dokümantasyon boşluğu bulma.

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

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

Önemli kilometre taşı Hermes’in kurulmuş olması değil. Ö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ın tadını çıkarılacak doğru yer burasıdır. Onayları açık tutun, aynı anda 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 makinesinde veya AlexHost’tan ya da başka bir yerden bir VPS üzerinde çalıştırırsanız, kural aynı kalır: güveni küçük adımlarla kazanın.