SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor

Agentlas OS VPS kurulumu ve self-host rehberi

Linux VPS üzerinde Agentlas OS v1.2.0 kurulumunu adım adım gerçekleştirin. Pinned install yöntemi, Ollama entegrasyonu ve boşta duran bir aracı merkezinin gerçek maliyeti.

Agentlas OS nedir

Agentlas OS, uzman aracıları diskte paketler halinde tutan ve her görev için geçici bir orkestratör oluşturan açık kaynaklı bir aracı çalışma zamanıdır. Yazılımı, bir Linux VPS üzerindeki kendi kullanıcı hesabınıza kurarak self-host edebilirsiniz. Aşağıda yer alan v1.2.0 sürümü sabitlenmiş komut satırı kurulumu bir servis değildir; yükleyici bir daemon etkinleştirmez veya dinleme portu açmaz. Projenin güncel dokümantasyonunda ayrıca ayrı bir masaüstü uygulaması da yer almaktadır.

Bu son ayrım, sayfadaki diğer tüm yapılandırmaları belirler. Çoğu çoklu aracı sistemi, sürekli çalışan ve aracıları barındıran bir denetleyici süreci kullanır. Agentlas ise bu yapıyı tersine çevirir: uzmanlar diskte hareketsiz dosyalardır ve orkestratör yalnızca bir görev yürütülürken var olur. Bunun pratik sonucu, boşta duran bir merkezin bellek değil, yalnızca disk alanı tüketmesidir.

Proje, açık çekirdeğini Hephaestus olarak adlandırır; komutlarda, yollarda ve ortam değişkenlerinde göreceğiniz isim budur. Depo agentlas-ai/Agentlas-OS adresindedir, Apache-2.0 lisansına sahiptir ve büyük ölçüde Python ile yazılmıştır.

Bu proje dürüst olmak gerekirse ne kadar yeni

13 Ekim 2026 tarihinde kaydedildiği üzere, depo yaklaşık dört aylıktı ve kabaca 1.580 yıldız ile 110 çatallanmaya sahipti. Gerçek iş yükleri için kullanılacak bir araç için bu oldukça genç bir yaştır.

Sürüm yayınlama sıklığı, projenin yaşından daha önemlidir. v1.1.103 sürümü 8 Ağustos 2026'da, v1.2.0 sürümü ise 12 Ağustos 2026'da yayınlandı. Bu, 1.1 serisinde yüzün üzerinde etiketlenmiş sürüm anlamına gelir; bazı günler birden fazla sürüm otomasyon tarafından yayınlanmıştır. 1.2 serisi de aynı hızı korudu: 10 Ekim 2026 itibarıyla v1.2.62 sürümüne ulaşılmıştı. Bu hızda ilerleyen bir proje, bir Salı ile Perşembe günü arasında davranış değişikliği gösterebilir.

Bu nedenle sürümü sabitleyin. Yükleyici bunun için bir ortam değişkeni okur ve aşağıdaki kılavuzun tamamı bunu kullanır. Bu sıklıkta sürüm yayınlayan bir projenin sabitlenmemiş kurulumu, genellikle betiğin en son düzenlendiği tarihte en son etiketlenen sürümü size sunar.

VPS üzerinde gerekenler

Boştaki uzmanlar süreç değil dosya olduklarından sistem gereksinimleri düşüktür.

  • Bir Linux VPS. Ubuntu 24.04 temel kurulum için uygundur. Yükleyici, işletim sistemini uname -s ile algılar ve Linux için macOS dışı bir dalı seçer; bu nedenle başsız (headless) sunucular desteklenir.
  • Sunucuda curl, tar ve git bulunmalıdır. Ayrıca, sabitlenmiş yükleyicinin paketlenmiş embedding modelini doğrulamak için kullandığı Python 3.9 veya daha yeni bir sürümü gereklidir.
  • Normal bir kurulum için raw.githubusercontent.com ve github.com adreslerine giden HTTPS trafiğine izin verilmelidir. Yükleyici, bir sürüm arşivini indirir ve SHA-256 değerini kontrol eder. Mevcut bağımsız yükleyici, HEPHAESTUS_SOURCE_DIR değişkenini standalone_local_source_unverified ile reddeder; bu değişken üzerinden çevrimdışı kurulum artık desteklenmemektedir.
  • Bir modelle fiilen iletişim kuran kodlama aracı olan bir ana bilgisayar donanımı (host harness). Claude Code, Codex, opencode, goose ve Hermes desteklenen adaptörlerdir.

root yetkisine ihtiyacınız yoktur. Yükleyici, ~/.local/bin dahil olmak üzere yalnızca ev dizininize yazma işlemi yapar. Yazılamayan bir yol gibi bir adım başarısız olduğunda, sistem uyarı verir ve kalan işlemlere devam eder; herhangi bir hata oluşursa işlem sonunda sıfır olmayan bir çıkış kodu döndürür. Eğer hala sunucunun kendisini seçme aşamasındaysanız, VPS üzerinde kodlama aracı çalıştırma rehberi, bu yapının üzerine kurulduğu temel imaj ve erişim ayarlarını kapsamaktadır.

Sabitlenmiş sürümü kurun

Upstream README dosyası, bir betiği doğrudan main üzerinden bash içine aktaran tek satırlık bir komut belgeliyor. v1.2.0 yükleyicisini indirin ve önce okuyun. Yükleyici, bulduğu her aracı (agent) donanımına yazma işlemi yapar, bu nedenle on saniyenizi ayırmanıza değer.

curl -fsSL -o install-all-runtimes.sh \
  https://raw.githubusercontent.com/agentlas-ai/Agentlas-OS/v1.2.0/scripts/install-all-runtimes.sh
less install-all-runtimes.sh
HEPHAESTUS_REF=v1.2.0 bash install-all-runtimes.sh

HEPHAESTUS_REF sabitleme değeridir. 8 Kasım 2026 itibarıyla, main üzerindeki betik release_ref="${HEPHAESTUS_REF:-os-v1.2.89}" kullanmaktadır ve sürümler sayfası bugün os-v1.2.89 altında yayınlanan Agentlas OS 1.2.89 sürümünü "Latest" (En Son) olarak etiketlemektedir. Mevcut yükleyici bir os-v etiketi gerektirir ve HEPHAESTUS_REF=v1.2.0 değerini standalone_channel_tag_invalid ile reddeder. Yukarıdaki eski yükleyici bu sabitleme değerini kabul eder.

Yukarıdaki betik URL'si hem yükleyiciyi hem de çalışma zamanı yükünü v1.2.0 sürümüne sabitler. Güncel bağımsız kurulumlar ~/.agentlas/os-runtime ve ~/.agentlas/os-bin/agentlas-os başlatıcısını kullanır; artık varsayılan olarak genel sarmalayıcılar (wrappers) kurmaz veya ana bilgisayar eklentilerini ve MCP'yi kalıcı olarak kaydetmez. Bu varsayılanlar, aşağıda açıklanan eski kurulum yönteminden farklıdır.

Sabitleme işlemi kurulumu kapsar, sonrasında gerçekleşenleri değil. v1.2.0 sürümünde, hephaestus komutları arka planda bir güncelleme denetimi başlatır; daha yeni bir sürüm mevcut olduğunda, bunu sorusuzca kurar ve ~/.agentlas/runtime/current işaretçisini günceller. Yükleyici, kendi çalışması için bunu HEPHAESTUS_AUTO_UPDATE=0 ile devre dışı bırakır; bu değişken, söz konusu eski sabitleme değerini korumanızı sağlayan yöntemdir. Bir sonraki adımda kabuk profilinize eklenecektir. Güncel bağımsız kurulumlarda otomatik güncellemeler varsayılan olarak kapalıdır.

Başarılı bir çalıştırma, yazdığı yolları ekrana basar; ~/.local/bin değeri PATH içinde bulunmadığında şu satırlar da buna dahildir:

Installed runner: /home/you/.agentlas/runtime/current/bin/hephaestus
Installed shell commands in /home/you/.local/bin (add ~/.local/bin to PATH to use them)

Bu PATH uyarısı, insanların göz ardı ettiği satırdır. Yeni bir Ubuntu makinesinde ~/.local/bin genellikle PATH içinde bulunmaz, bu nedenle kurulum başarılı olsa bile her hep-* komutu command not found hatasıyla başarısız olur. Bunu ~/.bashrc dosyasına ekleyin, aynı zamanda eski arka plan güncelleyiciyi kapatın ve doğrulayın:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
echo 'export HEPHAESTUS_AUTO_UPDATE=0' >> ~/.bashrc
source ~/.bashrc
hep-global status

hep-global, hephaestus global ifadesinin orijinal yazımıdır ve status, her bir donanım talimat dosyasının yönetilen yönlendirici bloğunu taşıyıp taşımadığını gösterir. Bu yönlendirici varsayılan olarak kapalıdır, bu nedenle herhangi bir rapor vermemesini bekleyin. Komut çalışıyorsa, PATH yapılandırmanız doğrudur.

Durum bilgisinin konumu

Her şey ev dizininiz altında bir dosya olarak tutulur; bu da yedekleme ve taşıma işlemlerini basitleştirir.

  • ~/.agentlas/runtime/1.2.0/ çalışma zamanının kendisini barındırır (yükleyici, etiketten baştaki v kısmını kaldırır) ve ~/.agentlas/runtime/current/ aktif sürüme işaret eden bir sembolik bağdır. İki sabitlenmiş sürüm yan yana bulunabilir.
  • ~/.local/bin/, hephaestus, hep-build, hep-network, hep-search, hep-storm, hep-cloud ve hep-upload dahil olmak üzere kabuk sarmalayıcılarını barındırır.
  • ~/.agentlas/networking/memory/ kalıcı belleği tutar: playbook-registry.json, playbook-candidates.jsonl ve memory-events.jsonl.
  • ~/.agentlas/networking/hub-agents/<slug>/memory/experience.sqlite, sahibi tarafından kapsamlandırılmış aracı bazlı deneyimi tutar.
  • <project>/.agentlas/ontology-runtime.sqlite proje bazlı durumu tutar; böylece bu veri sunucudan ziyade depo ile birlikte taşınır.
  • ~/.cache/agentlas/python Linux üzerinde Python önbelleğini tutar. macOS farklı bir yol kullanır; yükleyici uname ile bu dalı seçer.

v1.2.0 bellek dokümantasyonu, gizli anahtarların, ham kimlik bilgilerinin ve tam transkriptlerin herhangi bir bellek kapsamına alınmaması gerektiğini açıkça belirtir. Kimlik bilgisi değerleri gitignore edilmiş yerel dosyalarda kalır; bellek ise yalnızca isimleri ve yolları kaydeder. ~/.agentlas ve proje .agentlas dizinlerinizi yedeklediğinizde, yeni bir VPS üzerinde sistemi yeniden oluşturabilirsiniz.

Sunucudan dışarı çıkan tek bir veri vardır: sabitlenmiş v1.2.0 sürümünde, hep-build herhangi bir istem, yol veya aracı içeriği olmaksızın anonim derleme sayaçlarını varsayılan olarak gönderir. Bunu kapatmak için AGENTLAS_TELEMETRY=0 veya DO_NOT_TRACK=1 değişkenlerini ayarlayın ya da hem "telemetry": false hem de "telemetrySetBy": "user" değerlerini ~/.agentlas/networking/config.json içine ekleyin. Mevcut bağımsız telemetri varsayılan olarak kapalıdır.

Hangi model arka uçlarına yönlendirilebilir

Kurulumun tamamını yeniden çerçeveleyen detay şudur: Agentlas bir model API'sini çağırmaz. Bunu ana bilgisayar donanımı (harness) yapar.

Mimari belgesi, bir çekirdeği her donanıma çeviren çalışma zamanı bağdaştırıcılarını (adapter) tanımlar. README dosyası, bağdaştırıcının kendi sağlayıcı kimlik doğrulamasından sorumlu olduğunu ve çağrıyı yapan tarafın kendi modelini ve API erişimini sağladığını belirtir. Agentlas, bir donanımın aldığı iki yüzey sunar: bir AgentSkills dosyası ve stdio üzerinden haberleşen bir MCP (model context protocol) sunucusu. Dolayısıyla "Agentlas hangi modelleri destekliyor" sorusunun gerçek karşılığı "donanımınız hangi modelleri destekliyor" sorusudur; cevap ise Claude Code, Codex, opencode, goose veya Hermes'in erişebildiği her şeydir.

MCP sunucusunu kaydetmek, Codex tarzı bir TOML yapılandırmasında şu şekilde görünür:

[mcp_servers.hephaestus-network]
command = "~/.agentlas/runtime/current/bin/hephaestus"
args = ["mcp", "serve"]

Aynı sunucu, kurulum sırasında otomatik olarak ~/.cursor/mcp.json, ~/.config/goose/config.yaml ve diğer donanım yapılandırmalarına kaydedilir. Bunlardan birkaçını tek bir kutuya bağlıyorsanız, bir VPS üzerinde MCP sunucuları çalıştırma konusu, stdio ve süreç modelini daha derinlemesine ele almaktadır.

Self-hosted bir Ollama uç noktasına yönlendirme

Harness model bağlantısını yönettiği için, Agentlas'ı yerel modellere yönlendirmek, harness'ınızı Ollama'ya yönlendirmek anlamına gelir. Ollama, v0.15 sürümünde tam olarak bu işlem için bir launch alt komutu eklemiştir ve bu özellik 11 Ağustos 2026 itibarıyla v0.32.9 sürümünde de yer almaktadır. Bu komut, mevcut bir harness'ı herhangi bir ortam değişkeni ayarlamaya gerek kalmadan yerel modellere göre yapılandırır:

ollama pull qwen3-coder:30b
ollama launch opencode

Kurduğunuz harness'a bağlı olarak opencode yerine claude, codex veya droid değerini kullanın. Ardından bir isteği yerel çalışma zamanı üzerinden yönlendirin:

~/.agentlas/runtime/current/bin/hephaestus route "summarise the failing tests" --runtime ollama

Başarılı bir yönlendirme, seçilen ajanı veya ekibi belirten bir receipt_id içeren JSON formatında bir karar döndürür. Eğer anlamlı bir sonuç dönmüyorsa, bağlam uzunluğunu (context length) kontrol edin. v1.2.0 yerel model belgeleri, yoğun yönlendirme gerektiren oturumlar için en az 64k bağlam uzunluğuna sahip bir model kullanılmasını önerir ve örnek olarak qwen3-coder, gemma3 ve deepseek-r1 modellerini belirtir. Ollama'nın kodlama araçları için kendi kılavuzu da aynı 64k alt sınırını şart koşar. Yönlendirme kararları, ajan envanterini istem (prompt) içinde taşıdığından, 8k veya 32k bağlam uzunluğuna sahip bir model envanteri kırpar ve hatalı seçim yapar.

Sloganlarda belirtilmeyen bir uyarı mevcuttur. Ollama, Gemma ve DeepSeek kendi eklenti veya komut sistemlerine sahip değildir, bu nedenle /agentlas eğik çizgi (slash) komutları buralarda mevcut değildir. Ollama üzerinde başlatılan bir harness yine de kendi komutlarını, yeteneklerini ve eklentilerini sağlar; ham bir Ollama API döngüsü ise bunun yerine MCP sunucusunu veya hephaestus route komutunu kullanır. Bu durum, ham bir API döngüsü için saldırı yüzeyinde gerçek bir azalma sağlar.

Boşta bekleyen uzmanlar merkezinin RAM maliyeti

Hiçbir şey. Cevabın tamamı budur; buna inanmak yerine kanıtlayabilirsiniz.

Ödünç alınan merkez uzmanları, süreç olarak değil, paket yapıtları olarak gelir. Bir uzman, bir agent.md ve bir .agentlas/ JSON dizininden oluşur: tetikleyiciler ve yetenekler için routing-card.json, yazma sınırları için memory-map.json, tek başına mı yoksa bir ekip olarak mı çalışacağını belirlemek için mode-map.json. Hephaestus Network belgeleri, bir görev için çalışanlar başlatan bir çalıştırıcıyı tanımlar ve bu belgelerde dinleme portu açan veya bir servis etkinleştirmenizi isteyen hiçbir şey yoktur. Görevler arasında kendiniz kontrol edin:

pgrep -af hephaestus
systemctl --user list-units --type=service | grep -i agentlas
du -sh ~/.agentlas

Komutla tetiklenen çalışanlar çıktıktan sonra, ilk iki komut boşta bekleyen bir makinede hiçbir şey yazdırmaz, çünkü uzmanlar bellekte yerleşik değildir. Sabitlenmiş v1.2.0 sürümü, bir komut döndükten sonra kısa ömürlü, ayrılmış güncelleme ve yapı telemetrisi çalışanlarını çalışır durumda bırakabilir. HEPHAESTUS_AUTO_UPDATE=0, güncelleyicisini devre dışı bırakır; telemetri ise yukarıda açıklanan kendi devre dışı bırakma seçeneğine ihtiyaç duyar. Mevcut bağımsız güncelleme kontrolleri ve telemetri varsayılan olarak kapalıdır. Üçüncü komut, park halindeki bir merkezin size yüklediği tek maliyeti yazdırır; bu da disk maliyetidir ve tuttuğunuz uzman sayısı ile çalışma zamanının beraberinde getirdiği gömülü model ile birlikte artar.

Dolayısıyla bellek sorusu tamamen ani yük (burst) ile ilgilidir ve ani yük, donanımınız (harness) ile model arka ucunuzdan oluşur. Donanımınız barındırılan bir API ile iletişim kuruyorsa, yerleşik maliyet donanım sürecidir; bunun bellek kullanımı donanıma ve iş yüküne bağlıdır. Ağırlıkları kendiniz barındırıyorsanız, fatura ağırlıklara çıkar:

GrafikModel weights resident on the VPS, published Ollama download sizes, November 2026
Bu grafiğin arkasındaki veriler
[
  {
    "label": "Hosted API model",
    "weights_gb": 0
  },
  {
    "label": "gemma3:4b",
    "weights_gb": 3.4
  },
  {
    "label": "gemma3:12b",
    "weights_gb": 8.2
  },
  {
    "label": "gemma3:27b",
    "weights_gb": 17
  },
  {
    "label": "qwen3-coder:30b",
    "weights_gb": 19
  }
]

Bunlar, bir kıyaslama testinden alınan ölçümler değil, Ollama model kütüphanesinden yayınlanan indirme boyutlarıdır ve 64k bağlam için KV önbelleği, yukarıdaki sıfırın üzerindeki her rakamın üzerine eklenir. Agentlas belgelerinde ilk sırada adı geçen qwen3-coder:30b modeli, bağlam öncesinde 19 GB ağırlığa ihtiyaç duyar ve 27B Gemma varyantı bile 17 GB talep eder. Bu rakamlar karşısında, Agentlas katmanının kendisi bütçede görünmez.

Bunun tek bir harness çalıştırmakla karşılaştırması

Barındırılan bir API üzerinde tek bir harness çalıştırdığınızda VPS'niz tek bir süreç taşır. Agentlas eklediğinizde ise aynı harness'ı, ek dosyaları ve görev kapsamlı çalışma zamanı süreçlerini taşır. Orchestrator uzun ömürlü fazladan bir program değildir; diskteki paketlerden bir araya getirilen ve ardından atılan daha büyük bir istemdir (prompt).

Değişen maliyet bellek değil, bağlamdır (context). Birkaç uzman kartı ve bunların yönlendirme meta verilerini çeken bir orchestrator, görev başına çıplak bir harness'tan daha fazla token harcar. Barındırılan bir API'de bu durum RAM yerine para maliyeti doğurur. Yerel ağırlıklarda ise bu durum zaman maliyetidir; çünkü daha uzun bir istem, CPU üzerinde daha uzun bir ön doldurma (prefill) veya daha meşgul bir GPU anlamına gelir.

Bu nedenle, bunun gibi bir sunucu için boyutlandırma tavsiyesi, aracı çerçevesine (agent framework) değil, model kararına göre belirlenir. Bir kodlama aracı VPS'si için RAM ve CPU boyutlandırma konusu bunu ayrıntılı olarak ele alır ve varılan sonuç burada da geçerlidir: Çalıştırmayı planladığınız arka uç için uygun planı seçin, ardından harness için birkaç gigabaytlık ek alan bırakın. Karşılaştırma için her zaman açık bir denetleyici tasarımı istiyorsanız, Omnigent çoklu aracı harness'ı koordinatörünü bellekte tutar; bu tam tersi bir takastır ve boşta kalan bellek kullanımında doğrudan kendini gösterir.

Hata modları ve karşılaşacağınız dizgeler

Temiz bir kurulumdan hemen sonra hep-build: command not found. Sabitlenmiş yükleyici, bazı yeni kabukların PATH dosyasında bulunmayan ~/.local/bin yoluna yazma işlemi gerçekleştirdi. Bu durum, çıktının sonuna doğru belirtilmişti ancak uyarı gözden kaçmış olabilir. Yukarıda gösterilen export komutunu ~/.bashrc dosyasına ekleyin.

Sunucuyu yeniden oluşturduktan sonra davranış değişiklikleri. HEPHAESTUS_REF değişkenini ayarlamadınız, bu nedenle yükleyici, betiğinin o gün için belirlediği etiketi varsayılan olarak kullandı. Sürümü sabitleyin ve bu sabitlemeyi diğer sürüm numaralarınızın yanına kaydedin.

Yeniden oluşturma olmadan davranış değişiklikleri. Sabitlenmiş v1.2.0 sürümünde, arka plan güncelleyicisi daha yeni bir sürüm yükleyebilir ve ~/.agentlas/runtime/current yolunu bu sürüme taşıyabilir. current öğesinin nereyi işaret ettiğini kontrol edin ve HEPHAESTUS_AUTO_UPDATE=0 değişkenini yalnızca etkileşimli bir kabukta değil, donanımınızın (harness) çalıştığı ortamda da ayarlayın. Mevcut bağımsız otomatik güncellemeler varsayılan olarak kapalıdır.

Yönlendirme, yerel modelde yanlış uzmanı seçiyor. Modelin bağlam penceresinin (context window) aracı envanteri için çok küçük olup olmadığını kontrol edin. 64k veya daha büyük bir modele geçin ve Ollama bağlam uzunluğunu buna uygun şekilde ayarlayın. Ollama, 24 GiB VRAM altındaki sistemlerde varsayılan olarak 4k, 24 ile 48 GiB arası sistemlerde 32k ve 48 GiB ve üzeri sistemlerde 256k değerini kullanır; bu nedenle daha küçük yapılandırmalar açık bir artış gerektirir.

ollama launch tanınmıyor. Alt komut, Ollama v0.15 ile gelmiştir. Bir dağıtım deposundan alınan eski paketler bu sürümden daha eskidir, bu nedenle güncel bir Ollama sürümü yükleyin.

Kurulum, beklemediğiniz donanımlara (harness) yazıyor. Sabitlenmiş betik, bulduğu her donanımı algılar ve yapılandırır; ~/.claude/, ~/.codex/, ~/.gemini/, ~/.cursor/ ve daha fazlasına yazar. Ayrıca ~/.codex/config.toml gibi mevcut yapılandırma dosyalarını düzenler ve orijinalin yanında bir yedek oluşturur. Paylaşımlı bir derleme sunucusunda, betiği çalıştırmadan önce okuyun ve bu dizinlerden hangilerinin sizin için önemli olduğunu belirleyin.

Şu aşamada kullanmalı mısınız

Otomatik sürümlerle günde birkaç kez güncellenen bu kadar yeni bir proje, üretim ortamında çalıştırılmaya uygun değildir. Mimarisi oldukça ilgi çekicidir, Apache-2.0 lisansına sahiptir ve tüm durum bilgisi yedeklenebilir dosyalarda tutulur. Ancak kaldırılması göründüğü kadar temiz değildir: v1.2.0 sürümünün README dosyası herhangi bir kaldırma işlemi belgelemez, sabitlenmiş yükleyici ev dizininizdeki birden fazla konuma yazma yapar ve mevcut harness yapılandırmalarını değiştirir; ayrıca hephaestus global remove komutu yalnızca isteğe bağlı router bloğunu kaldırır. Bu gerçekler, projeyi tek kullanımlık bir sunucuda denemeyi kolay, ancak ona bağımlı hale gelmeyi maliyetli kılar.

Şu an için mantıklı olan yaklaşım şudur: etiketli yükleyicisini kullanarak v1.2.0 sürümünü sabitleyin, bu tarihsel sabitlemenin korunması için HEPHAESTUS_AUTO_UPDATE=0 ayarını yapın, projeyi yeniden oluşturabileceğiniz bir sunucuda çalıştırın, ~/.agentlas dosyasını yedeklerinizde tutun ve sabitlemeyi değiştirmeden önce değişiklik günlüğünü (changelog) tekrar okuyun. Bu alandaki diğer seçeneklerin neler olduğu ve ne kadar olgunlaştıkları hakkında daha geniş bir inceleme için self-hosted yapay zeka ajanları özeti daha iyi bir başlangıç noktasıdır; bir VPS üzerinde Hermes ajanı barındırma rehberi ise Agentlas'ın uyum sağladığı harness yapılarından birini ele alır.

FAQ

Agentlas OS VPS üzerinde bir sunucu olarak mı çalışır?

Sabitlenmiş v1.2.0 komut satırı kurulumu, bir daemon etkinleştirmez veya dinleme portu açmaz. Yükleyici, ~/.agentlas/runtime/ altında bir çalışma zamanı ve ~/.local/bin içine komut sarmalayıcıları yazar; Hephaestus Network ise arka plan servisi olarak değil, bir görev başlatıldığında çalışır. Komutla tetiklenen işçiler kapandığında, boşta duran bir makinede pgrep -af hephaestus hiçbir çıktı vermez. Sabitlenmiş sürüm, kısa ömürlü güncelleme ve yapı telemetri işçilerini başlatabilir: HEPHAESTUS_AUTO_UPDATE=0 güncelleyiciyi devre dışı bırakırken, AGENTLAS_TELEMETRY=0 veya DO_NOT_TRACK=1 telemetriyi kapatır. Mevcut bağımsız güncelleme denetimleri ve telemetri varsayılan olarak kapalıdır. Burada self-hosting ifadesi, kodun ve durumun sizin makinenizde olması anlamına gelir; bir servisin port dinlediği anlamına gelmez.

Boşta duran uzmanlardan oluşan bir merkez ne kadar RAM kullanır?

Hiç, çünkü boşta duran uzmanlar birer süreç değildir. Bir uzman, agent.md dosyası ve routing-card.json, memory-map.json gibi meta verileri tutan bir .agentlas/ dizininden ibarettir; bu nedenle park halindeki bir merkez yalnızca disk alanı kaplar. Bunu du -sh ~/.agentlas ile ölçebilirsiniz. Görevler ve kısa ömürlü arka plan işçileri bellek tüketir; park halindeki uzmanlar tüketmez.

Hangi modelleri kullanabilirim ve kendi Ollama sunucuma yönlendirebilir miyim?

Agentlas, model API'lerini kendisi çağırmaz. Ana bilgisayar donanımı (harness) kimlik bilgilerine ve bağlantıya sahiptir; bu nedenle desteklenen modeller, donanımınızın desteklediği modellerdir. Yerel ağırlıklar için, herhangi bir ortam değişkeni kullanmadan donanımı Ollama sunucunuza göre yapılandıran ollama launch opencode komutunu (claude, codex veya droid yerine koyarak) çalıştırın. Yönlendirme istemleri (routing prompts) ajan envanterini taşıdığından ve daha küçük pencerelerde ciddi kırpılmalara neden olduğundan, qwen3-coder veya gemma3 gibi en az 64k bağlam (context) kapasitesine sahip bir model kullanın.

Hangi sürümü yüklemeliyim ve sürüm sabitleme neden önemlidir?

v1.2.0 etiketinden yükleyiciyi getirerek ve yukarıda gösterildiği gibi HEPHAESTUS_REF=v1.2.0 ayarını yaparak, 12 Ağustos 2026 itibarıyla güncel olan v1.2.0 etiketli sürümü yükleyin. 8 Kasım 2026 itibarıyla, betiğin main üzerindeki varsayılanı release_ref="${HEPHAESTUS_REF:-os-v1.2.89}"'tür ve Agentlas OS 1.2.89, bugün os-v1.2.89 altında yayınlanan en son sürümdür. Mevcut yükleyici yalnızca os-v sürüm etiketlerini kabul eder ve eski v1.2.0 sabitlemesini reddeder. Sabitleme, normalden daha önemlidir çünkü proje 1.1 serisinde yüzün üzerinde sürüm yayınlamıştır; bazı günler birden fazla sürüm çıkmıştır. Bu nedenle, haftalar sonra sabitlenmemiş bir yeniden derleme, test ettiğiniz sistemi size vermeyecektir. Ayrıca, aksi takdirde güncelleyicinin arka planda daha yeni sürümleri yüklemesi ve sabitlemenin sessizce devre dışı kalması nedeniyle, geçmiş v1.2.0 çalışma zamanı için HEPHAESTUS_AUTO_UPDATE=0 ayarını yapın. Mevcut bağımsız otomatik güncellemeler varsayılan olarak kapalıdır.

Bu yazı işinize yaradı mı?