@insforge/cli ile Hermes Agent: CLI ile Bulut Altyapısı Yönetimi Deneyimi

Bir Hermes agent’ı çalıştırmak için sadece bir model ve bir CLI yeterli değil — arkasında sağlam bir altyapı olması gerekiyor. Veritabanı, edge functions, compute, AI gateway… Tüm bunları tek tek kurmak yerine @insforge/cli ile nasıl tek bir terminalden yönettiğimi anlatacağım.

CLI’nin gücü: Tek bir terminalden tüm altyapını yönet

@insforge/cli Nedir?

@insforge/cli (v0.1.81), InsForge platformu için geliştirilmiş bir komut satırı aracı. NPM üzerinden npx ile çalıştırabileceğiniz gibi global de kurabilirsiniz:

npx @insforge/cli --version
# → 0.1.81

Temel olarak şunları yapabiliyor:

Neden @insforge/cli?

Hermes agent çalıştırmak için genelde şu üç seçenek var:

1. Kendi sunucun — Full kontrol ama kurulum derdi
2. InsForge — Platform-as-a-Service, CLI ile yönetim
3. Modal / Railway — Serverless, sınırlı kontrol

Ben uzun süredir Hermes agent ile çalışıyorum — Nous Research’in açık kaynak AI agent framework’ü. Hermes’in gücü: CLI tabanlı, kalıcı hafızalı, tool-calling yetenekli ve kendi sunucunda çalışan bir AI asistanı.

Ama Hermes’in arka uç altyapısını yönetmek ayrı bir dert. İşte @insforge/cli tam bu noktada devreye giriyor.

Deneyim: Adım Adım

1. Oturum Açma

npx @insforge/cli login
# → Browser açılır, authenticate olursun
# → Token otomatik kaydedilir

npx @insforge/cli whoami
# → Email: ebartan@gmail.com
# → Name: Eray Bartan
# → Organization: Personal Org
# → Project: Eray Bartan

Terminalden çıkmadan kim olduğunu, hangi organda ve projede olduğunu görebiliyorsun. Çoklu proje yönetimi için current komutu da var:

npx @insforge/cli current
# → Mevcut context: user, org, project bilgisi

2. Proje Yönetimi

Hermes için yeni bir proje oluşturmak istediğimde:

npx @insforge/cli create
# → Interaktif sihirbaz: proje adı, template seçimi

npx @insforge/cli list
# → Tüm organizasyon ve projeleri listeler

link komutu ile mevcut bir dizini InsForge projesine bağlayabiliyorsun. config komutu ile de insforge.toml dosyasını yönetiyorsun — tüm proje yapılandırması tek bir dosyada.

3. Compute: Fly.io ile Docker Deployment

En sevdiğim özellik: compute yönetimi. Fly.io üzerinde Docker container çalıştırmak için:

# Mevcut compute servislerini listele
npx @insforge/cli compute list

# Detayları görüntüle
npx @insforge/cli compute get <id>

# Yeni servis deploy et (source mode - flyctl gerekli)
npx @insforge/cli compute deploy ./hermes-backend

# Ya da pre-built image ile deploy
npx @insforge/cli compute deploy --image ghcr.io/ebartan/hermes:latest

# Lifecycle yönetimi
npx @insforge/cli compute start <id>
npx @insforge/cli compute stop <id>
npx @insforge/cli compute update <id>

# Olayları izle
npx @insforge/cli compute events <id>

Hermes agent’ı bir Docker container olarak Fly.io’da çalıştırmak için bu komutlar yeterli. Source mode için flyctl gerekli, image mode için hiçbir ek araç gerekmiyor — bu büyük bir artı.

4. AI Gateway Setup

Hermes’in model çağrıları için OpenRouter kullanıyorum. @insforge/cli ile bunu kurulumu tek satır:

npx @insforge/cli ai setup
# → OpenRouter key'i projenin local .env dosyasına yazar

Bu küçük detay bile zaman kazandırıyor. Her projede aynı şeyi tekrar tekrar yapmak yerine tek komut.

5. Log ve Diagnostik

Hermes agent çalışırken sorun çıktığında:

# Container loglarını getir
npx @insforge/cli logs <source>

# Backend sağlık raporu
npx @insforge/cli diagnose

# Backend metadata (auth, database, buckets)
npx @insforge/cli metadata

# Örnek diagnose çıktısı:
# ✅ Auth: OK (JWT enabled)
# ✅ Database: Connected (PostgreSQL)
# ✅ Storage: Active
# ✅ Compute: Running (fly-app-1234)

6. Edge Functions ve Deployments

Hermes için yardımcı API’ler yazmak gerektiğinde:

# Edge function yönetimi
npx @insforge/cli functions

# Frontend deploy
npx @insforge/cli deployments

# Cron job tanımlama
npx @insforge/cli schedules

7. Secret Yönetimi

API key’ler, token’lar — Hermes’in can damarı:

npx @insforge/cli secrets
# → Tüm secret'ları tek yerden yönet

CLI ile Hermes Altyapısı: Tipik Bir Workflow

Hermes agent için yeni bir proje başlatırken izlediğim adımlar:

# 1. Yeni proje oluştur
npx @insforge/cli create --name hermes-agent-2

# 2. Compute deploy et (Hermes backend)
npx @insforge/cli compute deploy ./hermes-backend

# 3. AI gateway'i ayarla
npx @insforge/cli ai setup

# 4. Secret'ları yapılandır
npx @insforge/cli secrets set ANTHROPIC_API_KEY=sk-...
npx @insforge/cli secrets set OPENAI_API_KEY=sk-...

# 5. Cron job ekle (ör: günlük memory backup)
npx @insforge/cli schedules create \
  --schedule "0 6 * * *" \
  --command "./backup-memory.sh"

# 6. Logları izle
npx @insforge/cli logs hermes-agent --follow

# 7. Diagnostik çalıştır
npx @insforge/cli diagnose

# 8. Compute durumunu kontrol et
npx @insforge/cli compute list

Hepsi terminalden, hepsi tek bir CLI ile.

Artılar ve Eksiler

Artıları ✅

Eksileri ❌

Hermes ile Karşılaştırmalı

İkisi aslında birbirini tamamlıyor: Hermes agent çalışır, @insforge/cli altyapıyı yönetir.

Komut Ezberleme Rehberi

CLI’ın en güzel yanı: yardım her zaman yanında.

# Genel yardım
npx @insforge/cli --help

# Belirli bir komut için
npx @insforge/cli help compute

# JSON çıktı (script'ler için)
npx @insforge/cli list --json

# Onay atla (script'ler için)
npx @insforge/cli compute delete <id> -y

Sonuç

@insforge/cli, Hermes agent altyapısını yönetmek için ihtiyacım olan her şeyi tek bir terminal arayüzünde sunuyor. Özellikle:

1. Compute yönetimi — Fly.io üzerinde Docker container’ları başlat/durdur/güncelle
2. AI gateway — OpenRouter key yönetimi tek satırda
3. Log + diagnostik — Sorun çözerken can kurtaran
4. Secret yönetimi — API key’leri merkezi olarak güvende tut
5. Cron jobs — Hermes rutinleri için schedule yönetimi

En büyük artısı: öğrenme eğrisi neredeyse yok. Eğer daha önce aws-cli, flyctl veya railway gibi CLI araçları kullandıysanız, @insforge/cli’in mantığı size çok tanıdık gelecek.

Hermes agent ile InsForge platformunu birleştirmek, AI agent geliştirme sürecinde altyapı yükünü sıfıra indiriyor. Sadece agente odaklan, altyapıyı CLI’a bırak.

Kaynaklar

• @insforge/cli — NPM
• InsForge Platform
• Hermes Agent — Nous Research
• Fly.io
• OpenRouter

Bu yazıdaki hero görseli fal.ai + FLUX.1 Dev ile üretilmiştir.