DEV Community

Cover image for Hermes Agent Nasıl Kullanılır
Tobias Hoffmann
Tobias Hoffmann

Posted on • Originally published at apidog.com

Hermes Agent Nasıl Kullanılır

Kısaca: Hermes Ajan, öğrendiklerini hatırlayan ve zamanla daha akıllı hale gelen açık kaynaklı bir yapay zeka asistanıdır. Tek komutla kurun, LLM sağlayıcınızı yapılandırın ve CLI, Telegram, Discord veya IDE’niz üzerinden sohbet etmeye başlayın. Bu rehber, kurulumdan günlük kullanıma ve gelişmiş entegrasyonlara kadar Hermes’in pratik kullanımını adım adım gösterir.

Apidog'u bugün deneyin

Hermes Ajan Nedir?

Hermes Ajan, NousResearch tarafından geliştirilen, 7/24 çalışan ve öğrendiği her şeyi hatırlayan kişisel bir yapay zeka asistanıdır. ChatGPT veya Claude’dan farklı olarak, Hermes çalışma alışkanlıklarınızı ve projelerinizi kalıcı olarak modelleyerek sürekli gelişir.

Başlıca yetenekler:

  • Hatırlar: Sohbetleri, kararları ve kodları saklar
  • Öğrenir: Tekrar eden görevlerden beceri çıkarır
  • Çoklu platform: CLI, Telegram, Discord, Slack, WhatsApp veya IDE üzerinden kullanım
  • Kendi kendine barındırılır: Dizüstü, VPS veya bulutta
  • Modelden bağımsız: OpenRouter veya diğer sağlayıcılarla 200+ model
  • Genişletilebilir: Eklenti ve araç sistemi

Kimler için?

  • Kod tabanına hâkim bir yapay zeka eş programcısı isteyen geliştiriciler
  • Çok kullanıcı desteğiyle ekipler
  • Cron ile otomasyon isteyen ileri düzey kullanıcılar
  • Özel model eğiten araştırmacılar

Kurulum: Adım Adım

Ön Koşullar

  • İşletim Sistemi: macOS, Linux veya Windows (WSL önerilir)
  • Python: 3.10+
  • Git: Depo klonlamak için
  • API Anahtarı: OpenRouter, Anthropic, OpenAI veya diğer LLM sağlayıcıları

Hızlı Kurulum (Önerilen)

En hızlı kurulum için terminalde:

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

Bu, otomatik olarak Hermes’i klonlar, uv kurar, sanal ortam oluşturur, bağımlılıkları yükler ve PATH’e ekler.

Kabuğunuzu yeniden yükleyin:

source ~/.bashrc  # Bash
source ~/.zshrc   # Zsh

Kurulumu doğrulamak için:

hermes --version

Hermes Agent v0.5.0 benzeri bir çıktı görmelisiniz.

Manuel Kurulum (Geliştiriciler İçin)

Manuel adımlar:

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

curl -LsSf https://astral.sh/uv/install.sh | sh

uv venv venv --python 3.11
source venv/bin/activate      # Linux/macOS
# veya
.\venv\Scripts\activate       # Windows

uv pip install -e ".[all,dev]"
python -m pytest tests/ -q    # Kurulum doğrulama

RL Eğitim Desteği ile Kurulum

git submodule update --init tinker-atropos
uv pip install -e "./tinker-atropos"

İlk Kurulum ve Yapılandırma

Kurulum Sihirbazını Çalıştırın

hermes setup

Sihirbaz şunları yapmanızı ister:

  1. LLM sağlayıcı seçimi (OpenRouter, Anthropic, OpenAI, vs.)
  2. API anahtarlarını kurma
  3. Kalıcı hafıza ayarı
  4. Terminal arka ucu seçimi
  5. İsteğe bağlı mesajlaşma ağ geçidi kurulumu (Telegram, Discord, Slack)

Manuel Yapılandırma

hermes config edit

veya CLI ile:

hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend local
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...

Yapılandırma Dosyası Konumu

~/.hermes/
├── config.yaml      # Ana yapılandırma
├── .env             # API anahtarları
├── memory/          # Kalıcı hafıza
├── skills/          # Beceriler
└── plugins/         # Eklentiler

Kurulumu Doğrulayın

hermes doctor
  • Yapılandırma geçerliliği
  • API anahtarları
  • Bellek sistemi
  • Ağ geçidi
  • Terminal arka ucu

LLM Sağlayıcınızı Seçme

Hermes; OpenRouter, Anthropic, OpenAI ve Ollama gibi birçok sağlayıcıyı destekler.

OpenRouter (Yeni Başlayanlar İçin)

Kurulum:

hermes config set model openrouter
hermes config set OPENROUTER_API_KEY sk-or-...

Popüler modeller:

<!--kg-card-begin: html-->

Model

Kullanım Durumu

Maliyet

anthropic/claude-opus-4

Karmaşık kodlama, akıl yürütme

$$$

anthropic/claude-sonnet-4

Dengeli performans

$$

openai/gpt-4o

Genel amaçlı

$$

google/gemini-pro-1.5

Uzun bağlam pencereleri

$

meta/llama-3-70b

Açık kaynak, hızlı

$
<!--kg-card-end: html-->

Anthropic Doğrudan

hermes config set model anthropic
hermes config set ANTHROPIC_API_KEY sk-ant-...
hermes config set model.default claude-opus-4

OpenAI Doğrudan

hermes config set model openai
hermes config set OPENAI_API_KEY sk-...

Yerel Modeller (Ollama)

# Ollama'yı kurun: https://ollama.ai
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

Model Yapılandırma Örnekleri

Akıllı yönlendirme:

model:
  provider: openrouter
  default: anthropic/claude-opus-4
  fallback:
    - anthropic/claude-haiku-4-5
    - openai/gpt-4o-mini

Maliyet kontrolü:

model:
  budget:
    daily_limit: 5.00
    monthly_limit: 100.00

Temel Kullanım: CLI Modu

Hermes’i Başlatma

hermes

Hoş geldiniz mesajı gözükecek ve hemen sohbet edebilirsiniz.

Temel Komutlar

  • Sohbet:
> Merhaba, JSON ayrıştırmak için bir Python fonksiyonu yazabilir misin?
  • Slash komutları:
> /help
> /skills
> /memory
> /config
> /clear
> /history
  • Dosya tabanlı görevler:
> ./src/main.py dosyasına bak ve veritabanı bağlantısını yeniden düzenle
  • Terminal komutları:
> Çalıştır: npm install && npm run build

Her komut yürütmeden önce onay ister.

Kalıcı Kabuk

> cd /my/project && source venv/bin/activate
> python src/main.py

Kabuk durumu korunur; sanal ortam etkin kalır.

Dosyalarla Çalışma

Oku:

> config.yaml içeriğini göster

Düzenle:

> main.py dosyasında, veritabanı portunu 5432'den 5433'e değiştir

Yeni dosya oluştur:

> Tarih formatlama için yardımcı fonksiyonlar içeren utils.py adında yeni bir dosya oluştur

Çok Adımlı İş Akışları

> Flask uygulamama kullanıcı kimlik doğrulaması ekle:
> 1. Veritabanı modellerini ayarla
> 2. Giriş/çıkış uç noktaları oluştur
> 3. JWT üretimi ekle
> 4. Testler yaz

Her adımda onay isteyerek ilerler.

Mesajlaşma Ağ Geçidi: Telegram, Discord, Slack

Telegram Kurulumu

  1. Telegram’da @botfather ile /newbot oluşturun, jeton alın.
  2. Hermes’e jetonu ekleyin: 
    hermes config set TELEGRAM_BOT_TOKEN 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
  3. Ağ geçidini başlatın: 
    hermes gateway setup telegram
hermes gateway start
  4. Telegram’da botunuzla /start gönderip sohbet edin.

Discord Kurulumu

  1. Discord Developers üzerinden uygulama ve bot oluşturun, jetonu alın.
  2. Botu sunucuya davet edin (OAuth2 → URL Oluşturucu ile).
  3. hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
hermes gateway setup discord
hermes gateway start
  4. Botu etiketleyerek veya DM’de kullanın.

Slack Kurulumu

  1. Slack Apps üzerinden uygulama ve bot oluşturun.
  2. Jetonu alın, workspace’e kurun.
  3. hermes config set SLACK_BOT_TOKEN xoxb-...
hermes gateway setup slack
hermes gateway start

Çoklu Platform Kullanımı

hermes gateway start --all

Hermes tüm platformlarda konuşmaları senkronize eder.

IDE Entegrasyonu: VS Code, JetBrains

VS Code Entegrasyonu

  1. VS Code’da "Agent Communication Protocol" uzantısını kurun.
  2. Hermes ACP sunucusunu başlatın: 
    hermes acp start
  3. ACP yan panelinden Hermes’i ajan olarak seçin.

JetBrains Entegrasyonu (IntelliJ, PyCharm vb.)

  1. IDE eklentilerinden "ACP" veya "Agent Communication Protocol" eklentisini yükleyin.
  2. hermes acp start
  3. Ayarlar → Yapay Zeka Ajanları’ndan Hermes’i ekleyin.

Zed Düzenleyici

{
  "agent": {
    "provider": "acp",
    "endpoint": "hermes"
  }
}
hermes acp start

Bellek ve Öğrenme Sistemi

Bellek Türleri

  • Epizodik: Sohbet geçmişi ve oturumları saklar. 
    /memory search "veritabanı geçişi"
  • Semantik: Proje ve tercih grafikleri. 
    /memory projects
  • Prosedürel (Beceri): Tekrarlanan görevlerden çıkar. 
    /skills list

Oturum Araması

/memory search "Geçen hafta JWT son kullanma tarihini nasıl ele almıştık?"

Bellek İpuçları

[Hermes]: Kimlik doğrulama üzerinde çalıştığınızı fark ettim. Geçen Salı JWT ile ilgili bir sorun olmuştu. Gözden geçirmek ister misiniz?

Bağlam Sıkıştırması

  • %85 kullanımda ağ geçidi sıkıştırması
  • %50’de ajan düzeyinde sıkıştırma

Dışa Aktarma ve Yedekleme

hermes memory export ~/backup/hermes-memory.json
hermes memory import ~/backup/hermes-memory.json

Beceriler ve Eklentiler

Beceriler Nelerdir?

Beceriler, yeniden kullanılabilir iş akışlarıdır. Örnek:

  • code_review: Kod inceleme
  • debug_session: Hata ayıklama
  • api_tester: API testi
  • git_workflow: Git akışı
  • documentation: Otomatik belge üretimi

Becerilere Göz Atma ve Kurulum

/skills list
/skills install code_review
/skills run code_review ./src/auth.py

Özel Beceriler

# ~/.hermes/skills/my_skill.py
from hermes.skills import Skill

class MyCustomSkill(Skill):
    name = "my_custom_skill"
    description = "Faydalı bir şeyler yapar"

    def execute(self, context):
        return "Beceri başarıyla yürütüldü"

Eklenti Sistemi

# ~/.hermes/plugins/my_tool.py
from hermes.tools import Tool

class MyCustomTool(Tool):
    name = "my_tool"
    description = "Belirli görevler için özel bir araç"

    def run(self, **kwargs):
        return {"result": "success"}

Eklenti türleri: Araçlar, komutlar, kancalar

Gelişmiş Özellikler

Cron Zamanlaması

> GitHub bildirimlerimin günlük özetini sabah 9'da ayarla

veya config.yaml ile:

cron:
  - name: "Günlük özet"
    schedule: "0 9 * * *"
    command: "/skills run github_digest"
    model: "anthropic/claude-haiku-4-5"

Alt Ajan Delegasyonu

> Depomdaki tüm PR'ları incelemeni ve değişiklikleri özetlemeni istiyorum

Ses Modu

hermes --voice
  • Telegram/Discord: sesli mesaj gönderin, metne dönüşsün
  • Discord: sesli kanala katılabilir

Tarayıcı Kontrolü

> github.com'a git ve en popüler 5 Python deposunu bul
hermes browser connect --cdp

MCP Entegrasyonu

mcp:
  servers:
    filesystem:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "~/projects"]
    git:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-git"]

Çalışma Ağacı Modu

hermes -w

Birden fazla ajan aynı depoda çakışmadan çalışır.

Hermes İçinde Diğer Ajanları Çalıştırın

> Bu çekme isteğini incelemek için claude-code kullan

Sorun Giderme

Yaygın Sorunlar

API anahtarı bulunamadı

hermes config get OPENROUTER_API_KEY
hermes config set OPENROUTER_API_KEY sk-or-...

Model mevcut değil

hermes models list
hermes config set model anthropic/claude-opus-4

Ağ geçidi başlatılamadı

hermes gateway status
hermes gateway stop
hermes gateway start

Bellek bozulması

hermes memory export ~/backup/memory-backup.json
hermes memory reset
hermes memory import ~/backup/memory-backup.json

Yardım Alma

/help
hermes logs tail --follow
hermes doctor

SSS

Hermes’i çalıştırmak ne kadar?

  • Hafif kullanım: OpenRouter ile ayda 5-15$
  • Orta kullanım: 20-50$
  • Yoğun kullanım: 50-200$

Yerel modeller (Ollama) ücretsizdir, donanım gerekir.

Hermes 7/24 çalışabilir mi?

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

Hermes kurumsal için uygun mu?

  • Çok kullanıcılı ağ geçidi
  • PII redaksiyonu
  • Tedarik zincir güvenliği
  • Kendi kendine barındırma
  • Denetim günlüğü

OpenClaw’dan geçiş

hermes claw migrate --dry-run
hermes claw migrate
hermes doctor

İnternet olmadan Hermes

curl -fsSL https://ollama.ai/install.sh | sh
ollama pull qwen2.5-coder:32b
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

Hermes ve ChatGPT farkı

<!--kg-card-begin: html-->

Özellik

Hermes

ChatGPT

Bellek

Kalıcı, aranabilir

Yalnızca oturuma özel

Dağıtım

Kendi kendine barındırılır, 7/24

Yalnızca bulut

Model seçimi

200+ model

Yalnızca GPT

Genişletilebilirlik

Eklentiler, beceriler

Sınırlı

Maliyet

Yalnızca kullanım için ödeme

Abonelik

Gizlilik

Veriyi siz kontrol edersiniz

OpenAI veriyi depolar
<!--kg-card-end: html-->

Hermes verilerimi nasıl yedeklerim?

hermes export --all ~/backup/hermes-full-backup.tar.gz

Hermes yerel dosyalarıma erişebilir mi?

Yalnızca açıkça referans verdiğiniz veya izin verdiğiniz klasörlere erişebilir. Varsayılan olarak dosya sisteminize erişimi yoktur.

💡Yapay zeka destekli geliştirme iş akışınızda API'leri test etmek ister misiniz? API'leri tasarlama, test etme ve belgeleme için hepsi bir arada API geliştirme platformu Apidog'a göz atın.

Top comments (0)