Halkalı merkez mahallesi fatih cd ozgur apt no 46 , Küçükçekmece , İstanbul , 34303 , TR
Hermes Agent yalnızca sohbet eden bir model değildir; terminal, dosya, tarayıcı, web, hafıza, beceri, zamanlanmış görev, mesajlaşma kanalı ve MCP araçlarını aynı ajan çalışma döngüsünde birleştiren açık kaynaklı bir otomasyon katmanıdır. Bu rehber; ne olduğunu, hangi mimariyle çalıştığını, nasıl kurulacağını, güvenli biçimde nasıl yapılandırılacağını ve farklı sektörlerde hangi gerçek iş akışlarına dönüştürülebileceğini teknik ayrıntılarıyla anlatır.
Türkiye (Türkçe)
Almanya (German)
Worldwide (English)
hermes --versionv0.18.2
hermes doctor✓ runtime ✓ provider ✓ tools ✓ gateway
hermes chat --toolsets debuggingHazır: web + file + terminal
Klasik chatbot yanıt üretir. Ajan ise hedefi adımlara ayırır, araç çağırır, gerçek sistemlerden veri alır, çıktı doğrular ve gerektiğinde görevi sürdürür. Hermes Agent bu ajan döngüsünü model sağlayıcısından bağımsız, çok kanallı ve genişletilebilir bir çalışma zamanı olarak sunar.
Bir görevi planlar, uygun aracı seçer, çıktıyı denetler, gerektiğinde alt ajanlara böler ve sonucu aynı oturum içinde sürdürür.
Komutları yerel makinede, izole Docker konteynerinde, SSH ile uzak sunucuda veya bulut sandboxlarında çalıştırabilir.
Kullanıcı tercihlerini ve çalışma ortamı bilgisini sınırlı hafıza dosyalarında saklar; uzun prosedürleri gerektiğinde yüklenen skills olarak ayırır.
Tek seferlik veya tekrarlayan görevleri doğal dille ya da cron ifadesiyle çalıştırır ve sonucu seçilen kanala iletir.
GitHub, dosya sistemleri, veri tabanları, tarayıcılar ve kurumsal API'ler gibi dış araç sunucularını dinamik olarak ekleyebilir.
Kullanıcı allowlist'i, tehlikeli komut onayı, yazma sınırı, konteyner izolasyonu ve MCP ortam değişkeni filtreleme gibi katmanlar sunar.
Hermes tek başına iş sürecinizi bilmez. Güçlü sonuç için veri erişimi, araç izinleri, SOUL.md, proje bağlamı, skills, doğrulama kriteri ve insan onayı birlikte tasarlanmalıdır.
CLI, masaüstü, web paneli veya mesajlaşma kanalından gelen istek; SOUL.md, proje bağlamı, hafıza, etkin skills ve oturum geçmişiyle birleştirilir.
Nous Portal, OpenRouter, Anthropic, OpenAI Codex, GitHub Copilot, Ollama, vLLM veya uyumlu bir endpoint üzerinden model çağrılır.
Model, etkin toolset içinden web, dosya, terminal, tarayıcı, bellek, cron, görsel veya MCP aracını seçer.
Komut riski, dosya yolu, oturum yetkisi, platform allowlist'i ve sandbox kuralları yürütmeden önce değerlendirilir.
Araç sonucu modele döner. Ajan hatayı analiz eder, farklı yöntem dener veya görevi alt ajanlara böler.
Test, log ve iş hedefi doğrulanır; kalıcı tercih hafızaya, uzun prosedür skill'e, düzenli iş cron görevine dönüştürülebilir.
Aşağıdaki örnekler hazır paket değil, Hermes’in resmî araçlarından ve entegrasyon mimarisinden türetilmiş uygulanabilir tasarım kalıplarıdır. Her sektör için veri kaynağı, yetki, doğrulama ve insan onayı ayrıca planlanmalıdır.
Depoyu analiz eder, bağımlılıkları kurar, testleri çalıştırır, logları inceler ve kontrollü değişiklik planı oluşturur.
Disk, RAM, servis durumu, SSL süreleri, başarısız cronlar ve web sunucusu loglarını periyodik kontrol edip raporlayabilir.
Ürün verisini sınıflandırabilir, stok uyuşmazlıklarını raporlayabilir, içerik taslağı hazırlayabilir ve talepleri doğru ekibe yönlendirebilir.
Yeni rezervasyonları kontrol eder, uçuş saatini doğrular, araç ve şoför planını hazırlar, eksik bilgi varsa personele bildirir.
PMS verisini özetler, erken giriş taleplerini sınıflandırır, housekeeping listesi çıkarır ve vardiya brifi sunar.
Kaynak araştırır, içerik brifi oluşturur, çok dilli taslak hazırlar, yayın görevleri açar ve kampanya verilerini özetler.
Talepleri konu ve önceliğe göre ayırır, bilgi tabanından yanıt taslağı oluşturur ve kritik vakaları insana aktarır.
İlan verisini kontrol eder, eksik alanları listeler, müşteri ihtiyacını sınıflandırır ve danışmana görüşme özeti hazırlar.
Kaynaklardan ders özeti çıkarır, seviyeye göre alıştırma üretir, öğretmene değerlendirme taslağı sunar ve tekrar planlar.
Randevu hatırlatma, eksik evrak kontrolü ve genel bilgilendirmede kullanılabilir; teşhis veya tedavi kararı vermemelidir.
Sensör ve bakım kayıtlarını özetler, anormal değerleri işaretler ve Home Assistant üzerinden yetkili otomasyonlar çalıştırabilir.
Log korelasyonu, IOC araştırması, yapılandırma incelemesi ve olay raporu hazırlamada kullanılabilir.
Hermes Desktop yükleyicisi masaüstü uygulamasını ve komut satırı deneyimini birlikte kurar.
hermes desktopResmî kurulum betiği Python ortamını ve gerekli yardımcı bağımlılıkları hazırlar.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashPowerShell üzerinden resmî yükleme betiği çalıştırılır; ardından yeni terminalde doctor ile doğrulama yapılır.
iex (irm https://hermes-agent.nousresearch.com/install.ps1)İzole sanal ortam bağımlılık çakışmalarını azaltır.
python -m venv .venv
source .venv/bin/activate
pip install -U hermes-agent
hermesAjan konteynerde çalışır; config, anahtar, oturum, memory, skills ve cron hosttaki ~/.hermes dizininde kalır.
docker run -d \
--name hermes \
--restart unless-stopped \
-v ~/.hermes:/opt/data \
nousresearch/hermes-agent:latest gateway runÜretimde root hesabıyla sürekli çalıştırmayın; yalnız gerekli dizin ve komutlara izin verin.
Python, Node, ffmpeg, ripgrep, config ve sağlayıcı durumunu doğrulayın.
hermes model veya hermes setup --portal kullanın; anahtarları kod içine değil ~/.hermes/.env içine yazın.
Kişisel testte local; üretim, müşteri verisi ve otomasyonda Docker, SSH veya yönetilen sandbox tercih edin.
all yerine görev bazlı web,file,terminal veya safe gibi setler kullanın.
Teslim, hata, yeniden başlatma ve onay davranışını canlıya geçmeden doğrulayın.
Kurulum, sağlık, model ve araç durumunu kontrol eder.
hermes --version
hermes doctor
hermes model
hermes tools
hermes profileKalıcı veri ve otomatik yeniden başlatmayla gateway çalıştırır.
services:
hermes:
image: nousresearch/hermes-agent:latest
container_name: hermes
restart: unless-stopped
command: gateway run
ports:
- "8642:8642"
- "9119:9119"
volumes:
- ~/.hermes:/opt/data
environment:
- HERMES_DASHBOARD=1Docker backend, smart onay ve cron deny kullanır.
terminal:
backend: docker
cwd: /workspace
timeout: 180
approvals:
mode: smart
timeout: 60
cron_mode: deny
mcp_reload_confirm: true
destructive_slash_confirm: truePlatformları yapılandırır, servisi kurar ve logu izler.
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
tail -f ~/.hermes/logs/gateway.log| Sağlayıcı | Kurulum | Uygun kullanım |
|---|---|---|
| Nous Portal | hermes setup --portal | Model ve dört araç gateway'ini tek OAuth akışında yapılandırmak |
| OpenRouter | OPENROUTER_API_KEY | Farklı modelleri tek API üzerinden denemek |
| Anthropic | hermes model | Claude modellerini OAuth veya API anahtarıyla kullanmak |
| OpenAI Codex | hermes model | ChatGPT OAuth ile Codex odaklı çalışma |
| GitHub Copilot | hermes model | GitHub cihaz kodu veya CLI yetkisiyle model erişimi |
| Ollama | Yerel OpenAI uyumlu endpoint | Veriyi yerelde tutmak ve internet bağımlılığını azaltmak |
| vLLM | Self-hosted OpenAI uyumlu endpoint | GPU sunucuda yüksek hacimli özel model servisi |
Yapılandırma, kimlik bilgileri, hafıza, skills, cron, oturum ve logların ana kaynağıdır. Yedek politikasını bu dizin etrafında kurun.
~/.hermes/
├── config.yaml
├── .env
├── auth.json
├── SOUL.md
├── memories/
├── skills/
├── cron/
├── sessions/
└── logs/web_search, web_extractGüncel kaynak bulma ve sayfa içeriği çıkarma
read_file, write_file, patch, search_filesDosya okuma, üretme, değiştirme ve arama
terminal, process, read_terminalKomut çalıştırma ve uzun süreç yönetimi
browser, CDPEtkileşimli web ve tarayıcı otomasyonu
vision, image_gen, video, ttsGörsel analiz, üretim, video ve ses
memory, session_searchKalıcı bilgi ve geçmiş oturum araması
skill_view, skill_manage, skills_listİhtiyaca göre yüklenen prosedürler
delegate_taskİşi izole alt ajanlara bölme
cronjobTekrarlayan ve tek seferlik ajan görevleri
homeassistantYetkili akıllı ev ve IoT işlemleri
mcp_<server>_<tool>Dış araç sunucularından dinamik yetenekler
Her aracı her kanalda açmak yerine görev ve platform bazlı set kullanın. Müşteri destek botunda terminal kapalıyken yalnız iç ekip CLI oturumunda debugging seti etkin olabilir.
| Backend | Çalıştığı yer | İzolasyon | En uygun kullanım |
|---|---|---|---|
local | Hermes'in çalıştığı makine | Yok | Kişisel geliştirme ve güvenilir görevler |
docker | Kalıcı izole konteyner | Yüksek | Üretim, test ve güvenli komut yürütme |
ssh | Uzak sunucu | Ağ ve kullanıcı sınırı | VPS yönetimi ve uzak donanım |
modal | Bulut sandbox | Bulut VM | Geçici iş yükü ve değerlendirme |
daytona | Yönetilen workspace | Yönetilen konteyner | Takım geliştirme ortamları |
singularity | Apptainer/Singularity konteyneri | Namespace | HPC ve paylaşımlı sunucular |
Ortam bilgileri, proje kuralları ve kısa kalıcı notlar için karakter sınırı.
Kullanıcı tercihleri, iletişim biçimi ve beklentiler için karakter sınırı.
Uzun prosedürler yalnız ilgili olduğunda yüklenir.
SQLite tam metin aramasıyla geçmiş oturumlardan ilgili bilgi bulunur.
Kullanıcı tercihleri, ortam bilgisi, proje kuralları ve kalıcı çalışma standartları.
Kurulum, hata çözümü, marka dili, sektör süreci ve tekrarlanabilir araç kullanım sıraları.
coderAyrı Git/SSH araçları, proje skills'i ve teknik hafıza.
supportBilgi tabanı, sınırlı mesajlaşma araçları ve kişisel veri kuralları.
researchWeb, tarayıcı, kaynak doğrulama skill'i ve ayrı bütçe.
operationsCron, raporlama kanalları ve yalnız gerekli API kapsamları.
Profil Hermes state dosyalarını ayırır. Local backend aynı işletim sistemi kullanıcısının erişimini paylaşabilir. Gerçek izolasyon için backend, OS kullanıcısı, konteyner ve credential kapsamı da ayrılmalıdır.
hermes gateway setup etkin platformları gösterir ve servis başlatma seçeneği sunar.
DM pairing ve allowlist kullanın; terminal ve dosya araçlarını genel kanalda açmayın.
CLI geniş, müşteri mesajlaşması ise yalnız güvenli ve gerekli araçları kullanabilir.
Linux'ta systemd, macOS'ta launchd kurun ve gateway.log kayıtlarını merkezi sisteme aktarın.
Bir kullanıcının bota mesaj atabilmesi, terminal, dosya, veri tabanı veya kurumsal API araçlarını çalıştırmaya yetkili olduğu anlamına gelmemelidir. Platform kimliği ile araç yetkisini ayrı doğrulayın.
every 2hDisk, RAM, load, başarısız servisler ve kritik logları kontrol et; sorun varsa kanıt ve önerilen adımı bildir.
0 9 * * *Dünün sipariş, iptal, iade, düşük stok ve başarısız ödemelerini özetle; hiçbir kayıt değiştirme.
daily 06:30Bugünkü transferleri sırala, eksik uçuş veya araç bilgisini işaretle ve operasyon kanalına gönder.
Monday 08:0030 günden az kalan SSL sertifikalarını domain, tarih ve doğrulama yöntemiyle raporla.
Friday 15:00Son haftanın önemli gelişmelerini birincil kaynaklarla araştır ve yönetici özeti üret.
no-agentHazır scripti çalıştır ve stdout çıktısını değişiklik yapmadan hedef kanala ilet.
Doğal dil, klasik cron ifadesi ve manuel tetikleme örnekleri.
hermes cron create "every 2h" "Check server status and report actionable risks"
hermes cron create "0 9 * * *" "Prepare the daily operations brief"
hermes cron list
hermes cron run <job-id>
hermes cron pause <job-id>
hermes cron resume <job-id>Model Context Protocol, Hermes’e dış araç sunucularını standart yöntemle tanıtır. Bir MCP sunucusu yalnız çalıştığı için güvenilir sayılmamalı; kaynak kodu, araç manifesti, credential kapsamı ve allowed_tools listesi incelenmelidir.
Issue, pull request, repo araması ve proje operasyonlarını araç olarak sunar.
Salt okunur sorgu, raporlama veya kontrollü prosedür çağrıları için özel MCP kullanılabilir.
Belirlenen kök dizinlerle sınırlandırılmış dosya iş akışı oluşturur.
CRM, ERP, PMS, muhasebe veya destek sistemini ince tanımlı araçlara dönüştürür.
Yalnız belirlenen proje dizinini açan temel örnek.
mcp_servers:
filesystem:
command: npx
args:
- -y
- @modelcontextprotocol/server-filesystem
- /home/hermes/projects
allowed_tools:
- read_file
- list_directory
- search_filesBağımsız ajan profili ve hazır MCP preset'i oluşturur.
hermes profile create coder
coder setup
coder chat
hermes mcp add codex --preset codex
hermes mcp list
hermes mcp serveDesktop veya CLI + local backendEn hızlı kurulumdur; local backend OS kullanıcınızın erişebildiği dosyalara ulaşabilir.
Host Hermes + docker backendAjan hostta, komutlar kalıcı sertleştirilmiş konteynerde çalışır.
Docker Compose + ~/.hermes + reverse proxyAyrı servis kullanıcısı, firewall, TLS, yedek, log rotasyonu ve izleme kurun.
Gateway VPS + SSH backendHer hedefte ayrı kullanıcı ve sınırlı sudo kuralı kullanın; anahtarları döndürün.
Ayrı HERMES_HOME + ayrı credentialsProfil state ayırır fakat sandbox değildir; backend ve çalışma dizini ayrıca sınırlandırılmalıdır.
Modal veya Daytona backendHibernation, süre, veri yerleşimi ve maliyet ayarlarını izleyin.
Allowlist, DM pairing ve özel kanal politikası.
smart, manual veya off; üretimde smart/manual, cron için deny.
Korunan yollar ve HERMES_WRITE_SAFE_ROOT ile hedef kısıtlama.
Capability düşürme, no-new-privileges, PID ve tmpfs sınırları.
Alt süreçlere yalnız güvenli ve açıkça tanımlanmış env aktarımı.
Proje dosyalarında prompt injection ve şüpheli talimat denetimi.
Platform, kullanıcı ve cron oturumlarının durum ayrımı.
Backend yollarını allowlist ile doğrulayıp shell injection riskini azaltma.
Bir ajanı güvenli yapan tek ayar yoktur. Kimlik, ağ, işletim sistemi, araç, model, veri, süreç ve insan onayı birlikte ele alınmalıdır.
approvals.mode: off tehlikeli komut onaylarını kapatır. Yalnız tamamen izole, tek kullanımlık ve güvenilir CI/konteyner ortamlarında düşünülmeli; müşteri verisi, ana sunucu veya mesajlaşma gateway’i üzerinde kullanılmamalıdır.
Bu sunucuda son 30 dakikadaki 5xx artışını yalnız salt okunur komutlarla araştır. Nginx, PHP-FPM ve sistem kaynaklarını zaman damgasına göre karşılaştır. Hiçbir servisi yeniden başlatma. Bulguları kanıt, olası kök neden, güven düzeyi ve onay gerektiren sonraki adım şeklinde raporla.
Projeyi analiz et, hatayı mevcut testlerle yeniden üret, değişiklik planını yaz, yalnız ilgili dosyalarda düzeltme yap, test ve lint çalıştır. Başarısız testleri gizleme. Sonunda değişen dosyaları ve doğrulama çıktısını özetle.
Yönetilen sunucularda disk yüzde 80, inode yüzde 75, SSL 30 gün, load 10 dakika ve başarısız systemd servis eşiklerini kontrol et. Normal sonuçları kısa özetle; aksiyon gerektiren sorunlarda kanıt sun.
Bugünkü onaylı rezervasyonları saat sırasına göre düzenle. Uçuş numarası, terminal, yolcu sayısı, bagaj, araç ve şoför alanlarını doğrula. Eksik veya çakışan kayıtları ayrı listele. Müşteriye mesaj gönderme; yalnız operasyon kanalına taslak üret.
Son 24 saatte satılan ürünlerle stok hareketlerini karşılaştır. Negatif stok, yüksek iptal, sıfır fiyat ve sipariş-stok uyuşmazlıklarını bul. Veri değiştirme; SKU, kanıt ve önerilen kontrol adımıyla raporla.
Yeni destek taleplerini teknik, fatura, satış, güvenlik ve genel kategorilerine ayır. Acil güvenlik veya veri kaybı sinyallerini üst sıraya al. Bilgi tabanında doğrulanmış yanıt yoksa kesin cevap üretme ve insan incelemesine gönder.
Konuyu mevzuat, resmî dokümantasyon, araştırma ve piyasa verisi olarak dört alt başlığa böl. Her başlık için güncel birincil kaynak bul. Kaynaklar çelişirse iki görüşü de göster ve çıkarımları etiketle.
Yalnız belirtilen proje dizininde bağımlılık, secret sızıntısı, yanlış dosya izni ve güvenli olmayan yapılandırma kontrolü yap. Ağ taraması ve dış sisteme istek yapma. Bulguları dosya, satır, etki ve güvenli düzeltme önerisiyle raporla.
Kurulum dizini PATH'e eklenmemiş veya terminal yenilenmemiş olabilir.
Yeni terminal açın, PATH ayarını uygulayın ve hermes doctor çalıştırın.
API anahtarı, OAuth oturumu, model yetkisi veya sağlayıcı adı hatalıdır.
hermes model ile sağlayıcıyı yeniden seçin, ~/.hermes/.env izinlerini ve kotayı kontrol edin.
Toolset devre dışı, platform preset'i sınırlı veya gerekli credential yoktur.
hermes tools ile etkin setleri inceleyin ve yalnız gereken seti açın.
Docker daemon, kullanıcı grup yetkisi, image çekimi veya mount yolu sorunlu olabilir.
docker info ve docker ps ile hostu doğrulayın; config içindeki cwd ve mount yolunu kontrol edin.
Platform tokenı, webhook/polling, allowlist, DM pairing veya servis durumu sorunludur.
hermes gateway status ve gateway.log kayıtlarını inceleyip platform kurulumunu yeniden doğrulayın.
Teslim hedefi, kanal kimliği, toolset veya ajan hata durumu eksik olabilir.
Görevi hermes cron run ile elle çalıştırın; çalışma ve teslimi ayrı test edin.
Komut, paket yöneticisi, cwd, env veya OAuth kurulumu yanlıştır.
Aynı MCP komutunu Hermes dışında çalıştırın, gerekli env değerlerini açık tanımlayın ve araçları filtreleyin.
Profil dizini ile terminal.cwd aynı değildir; local backend başlatıldığı dizini kullanabilir.
Her profilde terminal.cwd için mutlak yol tanımlayın ve sandbox sınırını ayrıca kurun.
Kod tabanı MIT lisanslıdır. Model sağlayıcısı, web araçları, mesajlaşma servisleri, VPS, GPU ve üçüncü taraf API'ler ayrıca ücretli olabilir.
Hayır. Bir ajan çalışma zamanı ve araç katmanıdır. Çalışmak için Nous Portal, OpenRouter, Anthropic, Ollama, vLLM veya başka desteklenen sağlayıcıya bağlanır.
Evet. Hermes Desktop veya resmî PowerShell yükleyicisi kullanılabilir. Linux araçları gereken işlerde WSL2 veya Docker daha tutarlı olabilir.
Evet. Gateway, cron ve mesajlaşma için Docker veya servis kurulumu kullanılabilir. Kalıcı state, yedek, log rotasyonu, izleme ve ayrı servis hesabı kurulmalıdır.
Ollama veya vLLM gibi yerel endpointlerle temel ajan işlevleri kullanılabilir. Web, bulut tarayıcı, mesajlaşma ve dış API araçları internet gerektirebilir.
Savunma katmanları sunar fakat hiçbir LLM ajanı sınırsız üretim yetkisiyle güvenli kabul edilmemelidir. Minimum yetki, sandbox, allowlist, insan onayı, yedek ve izleme birlikte kullanılmalıdır.
Profil config, memory, sessions, skills, cron ve state dosyalarını ayırır. Local backend aynı OS kullanıcısının dosya erişimini paylaşabilir. Gerçek izolasyon için ayrı backend, kullanıcı veya konteyner gerekir.
Evet. No-agent modu hazırlanmış scripti zamanında çalıştırıp stdout çıktısını doğrudan teslim edebilir.
GitHub, veri tabanı, CRM, ERP veya özel API işlemlerini standart araç şemalarıyla eklemek için kullanılır. Kaynak kodu, araçlar ve credential kapsamı incelenmelidir.
Gateway WhatsApp dahil çok sayıda platform destekler. Müşteri iletişiminde platform politikası, izin, kişisel veri ve kullanıcı yetkilendirmesi ayrıca yönetilmelidir.
Evet. Profiller ayrı HERMES_HOME, config, memory, sessions, skills ve gateway state kullanır. Kaynak, port, credential ve çalışma dizini planlanmalıdır.
Hayır. İçerik ve teknik SEO güçlü bir temel sağlar fakat sıralama garanti edilemez. Güncellik, performans, indekslenebilirlik, iç bağlantılar, otorite ve kullanıcı faydası birlikte etkilidir.
Genel özellikler ve resmî dokümantasyon merkezi
Güncel sürüm ve değişiklik kayıtları
Windows, Linux, macOS, WSL2 ve Termux kurulumu
config.yaml, dizin ve terminal backendleri
Bulut ve yerel model sağlayıcıları
Yerleşik araç kayıt defteri
Skill oluşturma ve yönetim
MEMORY.md, USER.md ve oturum hafızası
Cron, teslim ve no-agent modu
Mesajlaşma platformları ve servis
Onay, izolasyon, dosya ve MCP güvenliği
Konteyner dağıtımı ve kalıcı veri
Bağımsız ajan profilleri
Ajan çekirdeği, araç, oturum ve gateway mimarisi
Hermes Agent hızlı gelişen bir projedir. Bu sayfadaki sürüm, araç sayısı ve platform bilgileri 28 Temmuz 2026 tarihinde doğrulanmıştır. Üretim öncesinde resmî release ve dokümantasyonu yeniden kontrol edin.
VPS kurulumu, Docker izolasyonu, özel skill geliştirme, MCP entegrasyonu, mesajlaşma gateway’i, cron otomasyonu ve sektörünüze özel ajan iş akışları için teknik danışmanlık alabilirsiniz.
Bu içerik bağımsız bir teknik rehberdir. Eka Yazılım ve Bilişim Sistemleri, Nous Research veya Hermes Agent projesiyle resmî olarak bağlantılı değildir.