Blog

Hermes Agent Nasıl Kullanılır

Ashley Innocent

Ashley Innocent

30 March 2026

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 bir komutla kurun, LLM sağlayıcınızı yapılandırın ve CLI, Telegram, Discord veya IDE'niz aracılığıyla sohbet etmeye başlayın. Bu kılavuz kurulumu, yapılandırmayı, günlük kullanımı, gelişmiş özellikleri ve Hermes'ten en iyi şekilde nasıl yararlanacağınızı kapsar.

button

Hermes Ajan Nedir?

Hermes Ajan, NousResearch tarafından geliştirilen, 7/24 çalışan, öğrendiği her şeyi hatırlayan ve zamanla daha yetenekli hale gelen kişisel bir yapay zeka asistanıdır. Her konuşmaya sıfırdan başlayan ChatGPT veya Claude'un aksine, Hermes çalışmalarınızın, projelerinizin ve tercihlerinizin kalıcı bir modelini oluşturur.

Temel yetenekler:

Hermes'i kimler kullanmalı:

Kurulum: Adım Adım

Ön Koşullar

Hızlı Kurulum (Önerilen)

Hermes'i kurmanın en hızlı yolu:

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

Bu betik:

  1. Hermes deposunu klonlar
  2. uv (hızlı Python paket yöneticisi) kurar
  3. Bir sanal ortam oluşturur
  4. Tüm bağımlılıkları kurar
  5. Hermes'i PATH'inize ekler

Kurulumdan sonra kabuğunuzu yeniden yükleyin:

source ~/.bashrc  # Bash için
source ~/.zshrc   # Zsh için

Kurulumu doğrulayın:

hermes --version

Hermes Agent v0.5.0 gibi bir şey görmelisiniz.

Manuel Kurulum (Geliştiriciler İçin)

Kurulum üzerinde daha fazla kontrol istiyorsanız:

# Depoyu klonlayın
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# uv'yi kurun (daha önce kurulu değilse)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Sanal ortamı oluşturun ve etkinleştirin
uv venv venv --python 3.11
source venv/bin/activate  # Linux/macOS
# veya
.\venv\Scripts\activate  # Windows

# Hermes'i tüm özellikleriyle kurun
uv pip install -e ".[all,dev]"

# Kurulumu doğrulamak için testleri çalıştırın
python -m pytest tests/ -q

RL Eğitim Desteği ile Kurulum

Özel modeller eğitmeyi planlıyorsanız:

# Atropos alt modülünü başlatın
git submodule update --init tinker-atropos

# Eğitim bağımlılıklarıyla kurun
uv pip install -e "./tinker-atropos"

İlk Kurulum ve Yapılandırma

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

İlk kez kullananlar etkileşimli kurulumu çalıştırmalıdır:

hermes setup

Sihirbaz size şu konularda rehberlik edecektir:

  1. LLM sağlayıcınızı seçme — OpenRouter, Anthropic, OpenAI vb.
  2. API anahtarlarını ayarlama — ~/.hermes/.env konumunda güvenli bir şekilde depolanır
  3. Hafızayı yapılandırma — Kalıcı hafızayı etkinleştirme/devre dışı bırakma
  4. Terminal arka ucu — Yerel, Docker, SSH veya bulut seçenekleri
  5. Ağ geçidi kurulumu — Telegram, Discord, Slack entegrasyonu (isteğe bağlı)

Manuel Yapılandırma

Manuel kurulumu tercih ediyorsanız, yapılandırma dosyasını düzenleyin:

hermes config edit

Veya CLI komutlarını kullanın:

# Varsayılan modeli ayarlayın
hermes config set model anthropic/claude-opus-4

# Terminal arka ucunu ayarlayın
hermes config set terminal.backend local

# API anahtarlarını ayarlayın (~/.hermes/.env dosyasına otomatik kaydeder)
hermes config set OPENROUTER_API_KEY sk-or-...
hermes config set ANTHROPIC_API_KEY sk-ant-...

Yapılandırma Dosyası Konumu

Hermes yapılandırmayı ~/.hermes/ içinde depolar:

~/.hermes/
├── config.yaml      # Ana yapılandırma
├── .env             # API anahtarları (paylaşmayın!)
├── memory/          # Kalıcı bellek depolaması
├── skills/          # Yüklü beceriler
└── plugins/         # Özel eklentiler

Kurulumunuzu Doğrulayın

Sağlık kontrolünü çalıştırın:

hermes doctor

Bu şunları kontrol eder:

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

Hermes, birden fazla sağlayıcı aracılığıyla 200'den fazla modeli destekler. İşte nasıl seçim yapacağınız:

OpenRouter (Yeni Başlayanlar İçin Önerilir)

Neden: Tek bir API anahtarı 200'den fazla modele erişim sağlar. Ücretsiz katman mevcuttur.

Kurulum:

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

OpenRouter'daki popüler modeller:

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ı

$

Anthropic Doğrudan

Neden: Sınıfının en iyisi kodlama ve akıl yürütme. En yeni Claude modellerine doğrudan erişim.

Kurulum:

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

OpenAI Doğrudan

Neden: Belirli kullanım durumları için GPT-4o ve o1 modelleri.

Kurulum:

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

Yerel Modeller (Ollama)

Neden: Ücretsiz, özel, çevrimdışı kullanılabilir.

Kurulum:

# Önce 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 (karmaşık görevler için pahalı model, basit görevler için ucuz model):

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

Maliyet kontrolü (harcama limitleri belirleyin):

model:
  budget:
    daily_limit: 5.00  # USD
    monthly_limit: 100.00

Temel Kullanım: CLI Modu

Hermes'i Başlatma

Hermes'i kullanmanın en basit yolu:

hermes

Bir hoş geldiniz başlığı göreceksiniz ve hemen sohbet etmeye başlayabilirsiniz.

Temel Komutlar

Hermes içinde şunları yapabilirsiniz:

Doğal olarak sohbet edin:

> Merhaba, JSON ayrıştırmak için bir Python fonksiyonu yazmama yardım edebilir misin?

Slash komutlarını kullanın:

> /help          # Tüm komutları göster
> /skills        # Mevcut becerilere göz at
> /memory        # Bellek durumunu görüntüle
> /config        # Yapılandırmayı görüntüle/düzenle
> /clear         # Mevcut konuşmayı temizle
> /history       # Geçmiş konuşmaları görüntüle

Dosya tabanlı görevler verin:

> ./src/main.py dosyasına bak ve veritabanı bağlantısını yeniden düzenle

Terminal komutlarını çalıştırın:

> Çalıştır: npm install && npm run build

Hermes, herhangi bir komutu yürütmeden önce onay isteyecektir.

Kalıcı Kabuk

Diğer yapay zeka araçlarının aksine, Hermes komutlar arasında kabuk durumunu korur:

> cd /my/project && source venv/bin/activate
> python src/main.py  # Aynı kabuk oturumunda çalışır

Sanal ortam sonraki komutlar için etkin kalır.

Dosyalarla Çalışma

Dosyaları oku:

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

Dosyaları düzenle:

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

Yeni dosyalar 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ı

Hermes, karmaşık, çok adımlı görevlerde üstündür:

> Flask uygulamama kullanıcı kimlik doğrulaması eklemem gerekiyor. Şunları yapabilir misin:
> 1. Veritabanı modellerini ayarla
> 2. Giriş/çıkış uç noktaları oluştur
> 3. JWT jetonu üretimi ekle
> 4. Kimlik doğrulama akışı için testler yaz

Hermes, her adımda ilerleyecek ve yol boyunca onay isteyecektir.

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

Hermes, birden fazla mesajlaşma platformunda bir bot olarak çalışabilir, böylece telefonunuzdan veya ekip sohbetinizden onunla etkileşim kurabilirsiniz.

Telegram Kurulumu

1. Bir bot oluşturun:

2. Hermes'i yapılandırın:

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. Sohbet etmeye başlayın:

Discord Kurulumu

1. Bir Discord uygulaması oluşturun:

2. Botu sunucunuza davet edin:

3. Hermes'i yapılandırın:

hermes config set DISCORD_BOT_TOKEN MTIzNDU2...
hermes gateway setup discord
hermes gateway start

4. Discord'da kullanın:

Slack Kurulumu

1. Bir Slack uygulaması oluşturun:

2. Çalışma alanına kurun ve jetonu kopyalayın

3. Hermes'i yapılandırın:

hermes config set SLACK_BOT_TOKEN xoxb-...
hermes gateway setup slack
hermes gateway start

Çoklu Platform Kullanımı

Birden fazla ağ geçidini aynı anda çalıştırabilirsiniz:

hermes gateway start --all

Hermes, konuşma durumunu tüm platformlarda senkronize eder.

IDE Entegrasyonu: VS Code, JetBrains

Hermes, Ajan İletişim Protokolü (ACP) aracılığıyla kod düzenleyicinizle doğrudan entegre olur.

VS Code Entegrasyonu

1. ACP uzantısını kurun:

2. Hermes'i arka uç olarak yapılandırın:

hermes acp start

3. VS Code'da kullanın:

JetBrains Entegrasyonu (IntelliJ, PyCharm vb.)

1. ACP eklentisini kurun:

2. Hermes ACP sunucusunu başlatın:

hermes acp start

3. JetBrains'te yapılandırın:

Zed Düzenleyici

Zed, yerel ACP desteğine sahiptir:

1. Zed ayarlarında yapılandırın:

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

2. Hermes'i başlatın:

hermes acp start

Bellek ve Öğrenme Sistemi

Hermes'in süper gücü, bellek mimarisidir. İşte onu etkili bir şekilde nasıl kullanacağınız.

Bellek Türleri

Epizodik Bellek: Belirli konuşmaları ve oturumları saklar. Geçmiş etkileşimleri arayabilir ve alabilirsiniz.

> /memory search "veritabanı geçişi"

Semantik Bellek: Projeleriniz, tercihleriniz ve kalıplarınız hakkında bilgi grafikleri oluşturur.

> /memory projects

Prosedürel Bellek (Beceriler): Tekrarlanan görevlerden yeniden kullanılabilir beceriler oluşturur.

> /skills list

Oturum Araması

Semantik arama ile ilgili geçmiş çalışmaları bulun:

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

Hermes, tüm geçmişinizi arar ve sonuçları özetler.

Bellek İpuçları

Hermes, ilgili bilgileri proaktif olarak yüzeye çıkarır:

[Hermes]: Kimlik doğrulama sistemi üzerinde çalıştığınızı fark ettim. Geçen Salı
JWT son kullanma tarihiyle ilgili bir sorundan bahsetmiştiniz. Bunu tekrar gözden geçirmek ister misiniz?

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

Hermes, limitlere takılmamak için bağlamı otomatik olarak sıkıştırır:

Bu, manuel bağlam yönetimi olmadan süresiz konuşmalara olanak tanır.

Dışa Aktarma ve Yedekleme

Belleği dışa aktar:

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

Belleği içe aktar:

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

Beceriler ve Eklentiler

Beceriler Nelerdir?

Beceriler, Hermes'in yürütebileceği yeniden kullanılabilir iş akışlarıdır. Onları karmaşık görevler için makrolar olarak düşünün.

Dahili beceriler şunları içerir:

Becerilere Göz Atın ve Kurun

Mevcut becerileri görüntüle:

> /skills list

Bir beceriyi kur:

> /skills install code_review

Bir beceriyi kullan:

> /skills run code_review ./src/auth.py

Özel Beceriler

~/.hermes/skills/ içinde özel beceriler oluşturun:

# ~/.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):
        # Beceri mantığınız burada
        return "Beceri başarıyla yürütüldü"

Eklenti Sistemi

Eklentiler, Hermes'i özel araçlar, komutlar ve kancalarla genişletir.

Bir eklenti oluşturun:

# ~/.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):
        # Araç mantığı burada
        return {"result": "success"}

Eklenti türleri:

Gelişmiş Özellikler

Cron Zamanlaması

Otomatik görevleri zamanlayın:

# Hermes'ten zamanlanmış bir görev oluşturmasını isteyin
> GitHub bildirimlerimin günlük özetini sabah 9'da ayarla

Veya config.yaml içinde manuel olarak yapılandırın:

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

Alt Ajan Delegasyonu

Hermes, paralel çalışma için alt ajanlar oluşturabilir:

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

Hermes, paralel çalışmak için birden fazla alt ajan oluşturacak ve ardından sonuçları sentezleyecektir.

Ses Modu

CLI'da bas-konuş:

hermes --voice

Telegram/Discord'da sesli notlar:

Discord sesli kanalları:

Tarayıcı Kontrolü

Hermes, web otomasyonu için Browser Use CLI 2.0 ile entegre olur:

> github.com'a git ve en popüler 5 Python deposunu bul

Veya CDP aracılığıyla canlı Chrome'a bağlanın:

hermes browser connect --cdp

MCP Entegrasyonu

Hermes, Model Bağlam Protokolü (MCP) sunucularını destekler:

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'i izole edilmiş bir git çalışma ağacında çalıştırın:

hermes -w

Birden fazla ajan, aynı depoda çakışma olmadan eşzamanlı olarak çalışabilir.

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

Hermes, diğer yapay zeka ajanlarını alt ajanlar olarak çalıştırabilir:

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

Bu, belirli görevler için uzmanlaşmış ajanlardan yararlanmak için kullanışlıdır.

Sorun Giderme

Yaygın Sorunlar

"API anahtarı bulunamadı"

# API anahtarının ayarlı olduğunu doğrulayın
hermes config get OPENROUTER_API_KEY

# Gerekirse yeniden ayarlayın
hermes config set OPENROUTER_API_KEY sk-or-...

"Model mevcut değil"

# Mevcut modelleri listele
hermes models list

# Modeli değiştir
hermes config set model anthropic/claude-opus-4

"Ağ geçidi başlatılamadı"

# Ağ geçidi durumunu kontrol et
hermes gateway status

# Ağ geçidini yeniden başlat
hermes gateway stop
hermes gateway start

"Bellek bozulması algılandı"

# Mevcut belleği yedekle
hermes memory export ~/backup/memory-backup.json

# Belleği sıfırla
hermes memory reset

# Gerekirse yeniden içe aktar
hermes memory import ~/backup/memory-backup.json

Yardım Alma

Dahili yardım:

> /help

Günlükleri görüntüle:

hermes logs tail --follow

Tanılama çalıştır:

hermes doctor

SSS

Hermes'i çalıştırmak ne kadara mal olur?

Hermes'in kendisi ücretsizdir. Yalnızca LLM kullanımı için ödeme yaparsınız. Tipik maliyetler:

Yerel modelleri (Ollama) kullanmak ücretsizdir ancak donanım gerektirir.

Hermes 7/24 çalışabilir mi?

Evet. Hermes'i bir VPS'ye dağıtın:

# VPS'ye kur
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# systemd hizmeti olarak çalıştır
hermes service install
hermes service start

Hermes kurumsal kullanım için uygun mu?

Evet. Kurumsal özellikler şunları içerir:

OpenClaw'dan nasıl geçiş yapabilirim?

hermes claw migrate --dry-run  # Önizleme
hermes claw migrate            # Tam geçiş
hermes doctor                  # Doğrula

İnternet olmadan Hermes'i kullanabilir miyim?

Evet, yerel modellerle:

# Ollama'yı kur
curl -fsSL https://ollama.ai/install.sh | sh

# Bir model çek
ollama pull qwen2.5-coder:32b

# Hermes'i yapılandır
hermes config set model ollama
hermes config set model.default qwen2.5-coder:32b

Hermes ve ChatGPT arasındaki fark nedir?

Ö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

Hermes verilerimi nasıl yedeklerim?

# Her şeyi dışa aktar
hermes export --all ~/backup/hermes-full-backup.tar.gz

Hermes yerel dosyalarıma erişebilir mi?

Hermes yalnızca açıkça referans verdiğiniz veya izin verdiğiniz dizinlerdeki dosyalara erişebilir. Varsayılan olarak, dosya sisteminize erişimi yoktur.

💡
Yapay zeka destekli geliştirme iş akışınızın bir parçası olarak 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.

button

API Tasarım-Öncelikli Yaklaşımı Apidog'da Uygulayın

API'leri oluşturmanın ve kullanmanın daha kolay yolunu keşfedin

Ücretsiz Kaydolİndir
Hermes Agent Nasıl Kullanılır