Hermes Agent’ı Docker ile Çalıştırma: Konteyner Ortamında AI Ajan Kurulumu

Hermes Agent, Nous Research tarafından geliştirilen açık kaynaklı bir AI ajandır. Geliştiriciler ve sistem yöneticileri için terminal üzerinden çalışan bu aracı Docker konteyneri içinde çalıştırmak, izole ve taşınabilir bir ortam sağlar. Hermes Agent Docker kurulumu, özellikle farklı makineler arasında tutarlı bir çalışma ortamı isteyenler için ideal bir çözümdür. Bu yazıda Hermes Agent’ı adım adım Docker ile nasıl çalıştıracağınızı anlatıyorum.

Neden Hermes Agent’ı Docker ile Kullanmalısınız?

Docker konteynerleri, yazılımları izole bir ortamda çalıştırmanın en pratik yoludur. Hermes Agent’ı Docker ile kullanmanın başlıca avantajları:

• Taşınabilirlik: Bir kere yapılandır, her yerde çalıştır. Aynı Docker imajı Linux, macOS ve Windows’ta birebir aynı şekilde çalışır.
• İzolasyon: Konteyner içindeki bağımlılıklar ana sisteminizi etkilemez. Python sürüm çakışmaları, kütüphane uyumsuzlukları gibi sorunlar yaşamazsınız.
• Kolay dağıtım: Sunucu veya CI/CD ortamlarında Hermes Agent’ı saniyeler içinde ayağa kaldırabilirsiniz.
• Geri alınabilirlik: Yanlış bir yapılandırma yaptığınızda konteyneri silip yeniden başlatmanız yeterlidir.

Ön Koşullar

Başlamadan önce sisteminizde Docker’ın kurulu olduğundan emin olun. Docker yoksa resmi Docker dokümantasyonundan kurulum yapabilirsiniz. Ayrıca bir OpenRouter, OpenAI veya Anthropic API anahtarına ihtiyacınız olacak — bu anahtarları güvenli şekilde .env dosyasında saklama yöntemini tercih etmelisiniz.

Adım 1: Dockerfile Oluşturma

İlk adım, Hermes Agent için özel bir Dockerfile oluşturmak. İşte üretim ortamına uygun bir Dockerfile:

# Dockerfile - Hermes Agent
FROM python:3.13-slim

WORKDIR /app

# Sistem bağımlılıkları
RUN apt-get update && apt-get install -y --no-install-recommends     git     curl     && rm -rf /var/lib/apt/lists/*

# Hermes Agent kurulumu
RUN pip install --no-cache-dir hermes-agent

# Varsayılan yapılandırma
COPY config.yaml /root/.hermes/config.yaml
COPY .env /root/.hermes/.env

ENTRYPOINT ["hermes"]
CMD ["--help"]

Bu Dockerfile, resmi Python 3.13 imajını temel alır, gerekli araçları kurar ve Hermes Agent’ı PIP aracılığıyla yükler.

Adım 2: Yapılandırma Dosyasını Hazırlama

Hermes Agent’ın config.yaml dosyası, hangi modeli, sağlayıcıyı ve ayarları kullanacağınızı belirler. Örnek bir yapılandırma:

# config.yaml
default:
  provider: openrouter
  model: deepseek/deepseek-v4-flash
  max_tokens: 4096
  temperature: 0.7
  skills_dir: /root/.hermes/skills/

Dilerseniz Hermes Agent yapılandırma rehberimizdeki detaylı ayarları inceleyebilirsiniz.

Adım 3: Docker Compose ile Çalıştırma

Docker Compose, çoklu konteyner yapılandırmaları için en pratik yöntemdir. İşte Hermes Agent için bir compose.yaml dosyası:

# compose.yaml
version: '3.8'
services:
  hermes:
    build: .
    container_name: hermes-agent
    volumes:
      - ./skills:/root/.hermes/skills
      - ./config.yaml:/root/.hermes/config.yaml
      - ./.env:/root/.hermes/.env
      - ./data:/opt/data
    environment:
      - TERM=xterm-256color
    stdin_open: true
    tty: true
    entrypoint: ["hermes"]

Bu yapılandırma ile skills klasörünüzü, yapılandırma ve env dosyalarınızı konteynere bağlayarak verilerinizi kalıcı hale getirebilirsiniz.

Adım 4: Konteyneri Başlatma

Tüm dosyalar hazırsa, aşağıdaki komutlarla Hermes Agent’ı Docker üzerinde çalıştırabilirsiniz:

# İmajı oluştur
docker compose build

# Konteyneri başlat
docker compose run --rm hermes

--rm bayrağı, konteyner durduğunda otomatik olarak silinmesini sağlar. Kalıcı bir konteyner isterseniz docker compose up -d komutunu kullanabilirsiniz.

Adım 5: Cron Jobs ve Zamanlanmış Görevler

Hermes Agent’ın en güçlü özelliklerinden biri, zamanlanmış görevleri (cron jobs) desteklemesidir. Docker ortamında cron görevlerini çalıştırmak için host makinedeki cron’u kullanabilirsiniz:

# Host crontab - her sabah 09:00'da (Türkiye saati)
0 6 * * * cd /opt/hermes-project && docker compose run --rm hermes "Günlük raporu hazırla"

Bu yöntemle Hermes Agent’ın skills ve memory özelliklerinden tam olarak faydalanabilir, konteyner her yeniden başladığında aynı profili kullanabilirsiniz.

Güvenlik İpuçları

Docker ile Hermes Agent kullanırken güvenliğe dikkat etmek önemlidir:

• .env dosyasını asla Docker imajına gömme, her zaman volume olarak bağla.
• API anahtarlarını versiyon kontrol sistemine ekleme — .gitignore dosyasına .env ve config.yaml satırlarını mutlaka ekleyin.
• Konteynere sadece ihtiyaç duyduğu dizinleri bağlayın, tüm sistemi bağlamayın.
• Üretim ortamında --read-only bayrağı ile konteyner dosya sistemini salt okunur yapabilirsiniz.

Sonuç

Hermes Agent’ı Docker ile çalıştırmak, geliştirme ve üretim ortamları arasında tutarlılık sağlamanın en etkili yoludur. Bu rehberdeki adımları izleyerek Hermes Agent Docker kurulumunuzu dakikalar içinde tamamlayabilir, izole ve taşınabilir bir AI ajan ortamına kavuşabilirsiniz.

Hermes Agent hakkında daha fazla bilgi için blog arşivimizi ziyaret edebilir, yapay zeka araçları ve WordPress çözümleriyle ilgili güncel içerikleri takip edebilirsiniz.