Hermes Agent Nasıl Kurulur? Linux, macOS ve WSL için Başlangıç Rehberi

Yapay zeka ajanları (AI agent) yazılım geliştirme, sunucu yönetimi ve içerik otomasyonu gibi iş akışlarını yeniden tanımlıyor. Hermes Agent, Nous Research tarafından geliştirilen açık kaynak bir AI ajan çerçevesi. Claude Code, Codex (OpenAI) ve OpenClaw ile aynı kategoride yer alıyor ancak onlardan farklı olarak çok sayıda model sağlayıcısını destekliyor, kendi yeteneklerini sonradan öğrenebiliyor (skills sistemi) ve Telegram, Discord, Slack gibi platformlardan da çalışabiliyor.

Bu yazıda Hermes Agent kurulumunu sıfırdan, üç farklı işletim sisteminde adım adım anlatıyorum. İster Linux sunucuda çalışıyor olun, ister macOS kullanıyor olun, ister Windows üzerinde WSL ile Linux ortamı açmış olun — Hermes Agent’ı dakikalar içinde ayağa kaldırabilirsiniz.

Hermes Agent Nedir?

Hermes Agent, terminal üzerinden komut alan, dosya sistemiyle etkileşime giren, web’de arama yapan, WordPress gibi platformlarla REST API üzerinden konuşabilen bir AI ajanıdır. OpenRouter, Anthropic, OpenAI, DeepSeek, Google Gemini ve 15’ten fazla sağlayıcı ile çalışır. Bu sayede kendinize en uygun modeli seçip aynı ajan üzerinde kullanabilirsiniz.

En önemli özelliklerinden biri skills (beceri) sistemi. Hermes çözdüğü karmaşık bir problemi skill olarak kaydeder ve sonraki oturumlarda tekrar kullanır. Zamanla sizin çalışma tarzınıza ve ortamınıza göre kendini geliştirir.

Sistem Gereksinimleri

Hermes Agent kurulumu için gerekenler oldukça basit:

• Python 3.10 veya üzeri (önerilen: 3.11+)
• curl veya wget (kurulum script’ini indirmek için)
• Linux: Ubuntu 20.04+, Debian 11+, Fedora, Arch veya herhangi bir modern dağıtım
• macOS: Ventura (13.0) veya üzeri
• Windows: WSL2 ile Ubuntu (önerilir)
• İnternet bağlantısı (API çağrıları ve paket indirme için)

Hermes Agent kurulumu için özel bir GPU’ya veya yüksek RAM’e ihtiyacınız yok. Local modellerle çalışmak isterseniz daha fazla kaynak gerekebilir ama varsayılan olarak API tabanlı modeller kullanılır.

Adım 1: Hermes Agent Kurulumu

En hızlı kurulum yöntemi resmî install script’ini kullanmak. Tek komut ile Hermes Agent’ı kurabilirsiniz:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Bu komut Hermes Agent’ı sisteminize kurar, gerekli Python bağımlılıklarını yükler ve hermes komutunu PATH’e ekler. Kurulum tamamlandıktan sonra terminale şunu yazarak çalıştığını doğrulayabilirsiniz:

hermes --version

Eğer versiyon numarasını görüyorsanız kurulum başarılı demektir.

Alternatif Kurulum Yöntemleri

Install script’i çalışmazsa veya manuel kurulum tercih ederseniz:

# Git ile klonla
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Pip ile yükle (tercihen bir sanal ortama)
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Hermes’ı pip install hermes-agent ile de kurabilirsiniz ama GitHub’daki en güncel sürümü almak için resmî Git deposunu kullanmanızı öneririm.

Adım 2: API Anahtarınızı Ayarlama

Hermes Agent bir AI modeline bağlanmak için bir API anahtarına ihtiyaç duyar. En kolay başlangıç OpenRouter ile. OpenRouter tek bir API anahtarıyla 200’den fazla modele erişim sağlar.

1. OpenRouter Keys sayfasına gidin.
2. Hesap oluşturun ve yeni bir API anahtarı alın.
3. Anahtarı Hermes’ın yapılandırma dosyasına ekleyin:

hermes setup

hermes setup komutu sizi etkileşimli bir kurulum sihirbazında karşılar. Burada API anahtarınızı girebilir, varsayılan modeli seçebilir ve terminal ayarlarını yapılandırabilirsiniz. Alternatif olarak hermes model komutu ile doğrudan model ve sağlayıcı seçimi yapabilirsiniz.

API anahtarlarını ayrıca ~/.hermes/.env dosyasına manuel olarak da ekleyebilirsiniz:

OPENROUTER_API_KEY=YOUR_API_KEY

Not: Gerçek API anahtarınızı asla herkese açık kodlarda, yazılarda veya versiyon kontrol sistemlerinde paylaşmayın. .env dosyasının izinlerini chmod 600 ile kısıtlamak iyi bir güvenlik alışkanlığıdır.

Adım 3: Sağlık Kontrolü

Kurulumu ve API bağlantısını doğrulamak için Hermes’ın yerleşik sağlık kontrol aracını kullanın:

hermes doctor

Bu komut Python sürümünüzü, bağımlılıkları, API anahtarlarının varlığını ve yapılandırma dosyasının geçerliliğini kontrol eder. Eksik bir şey varsa ne yapmanız gerektiğini adım adım gösterir.

Adım 4: İlk Komutu Çalıştırma

Artık Hermes Agent hazır. Etkileşimli sohbet modunda başlatmak için:

hermes

Terminalde bir karşılama mesajı ve bir komut istemi göreceksiniz. Basit bir test yapalım:

hermes chat -q "Türkiye'nin başkenti neresi?"

Eğer “Ankara” yanıtını alırsanız Hermes Agent başarıyla çalışıyor demektir. Tek seferlik sorgular için -q flag’i kullanışlıdır; etkileşimli oturumlar için hiçbir flag eklemeden hermes yazmanız yeterli.

Platforma Göre Ek Notlar

Linux (Ubuntu/Debian)

Hermes doğal olarak Linux’ta en iyi performansı verir. Kurulum script’i tüm bağımlılıkları otomatik yükler. Ubuntu’da ek bir adım gerekmez.

macOS

macOS’ta Homebrew üzerinden Python 3.11 yüklemenizi öneririm. Kurulumdan sonra Hermes’ın PATH’te olduğunu doğrulayın. Terminal izni için macOS’un Güvenlik ayarlarına takılabilirsiniz — ilk çalıştırmada Terminal’e izin vermeniz yeterli.

Windows WSL

Windows’ta Hermes kullanmak için WSL2 şart. WSL2’ye Ubuntu kurduktan sonra yukarıdaki Linux komutlarının aynısını kullanabilirsiniz. Önemli not: WSL2’de systemd desteğini açmak için /etc/wsl.conf dosyasına systemd=true ekleyin. Aksi halde gateway servisi kapandığında otomatik başlamaz.

Sık Karşılaşılan Kurulum Sorunları

Kurulumda karşılaşabileceğiniz birkaç yaygın sorun ve çözümü:

• “hermes: command not found”: PATH’e eklenmemiş olabilir. Shell’i yeniden başlatın veya source ~/.bashrc ile profili yeniden yükleyin.
• Python sürüm hatası: Python 3.10 altındaysa python3 --version ile kontrol edin ve apt install python3.11 (Linux) veya brew install python@3.11 (macOS) ile güncelleyin.
• API anahtarı geçersiz: hermes doctor ile kontrol edin. Anahtarı hermes config edit ile düzeltebilir veya hermes setup ile yeniden yapılandırabilirsiniz.
• curl hatası: curl --version ile curl’in kurulu olduğundan emin olun. Alternatif olarak wget ile kurulum yapabilirsiniz.

Sonraki Adımlar

Hermes Agent kurulumu tamamlandıktan sonra yapabilecekleriniz:

• Telegram üzerinden kullanmak: hermes gateway setup ile Telegram bot bağlantısı kurabilir, telefondan komut verebilirsiniz.
• Görev otomasyonu: hermes cron create ile günlük tekrar eden işleri otomatikleştirebilirsiniz.
• WordPress yönetimi: Hermes REST API üzerinden sitenizde yazı yayınlayabilir, içerik oluşturabilir.
• Özel beceriler (skills): Kendi iş akışlarınızı Hermes’e öğretip tekrar tekrar kullanabilirsiniz.

Bu konuların her birini bu serideki diğer yazılarda detaylıca ele alacağım. Blog sayfasından yeni yazıları takip edebilirsiniz. Eğer bir WordPress veya web tasarım projeniz varsa ve otomasyon konusunda yardım isterseniz iletişim sayfasından bana ulaşabilirsiniz.

Özetle: Hermes Agent, tek komutla kurulabilen, çoklu model desteği olan, açık kaynak bir AI ajan framework’üdür. Linux, macOS ve WSL üzerinde dakikalar içinde çalışır hale gelir. Hermes Agent kurulumu bu kadar basit — şimdi sıra sizde, kendi ajanınızı başlatın ve neler yapabileceğini keşfedin.