Dokümantasyon / Başlarken

ivralo nedir

ivralo, ağın dışına çıkamayan kod için yazılmış bir AI SRE. Kendi makinenizde ya da sunucunuzda çalışır, tek bir git repo'su üzerinde iş görür, seçtiğiniz modelle konuşur ve durumunu kendi PostgreSQL'inizde tutar.

İki mod, tek motor

ivralo tek bir motor, iki modda çalışır. Mod dediğimiz şey yalnızca bir yetki kümesi: başında kimse yokken bir çalıştırmanın neler yapabileceğini ve neyi önce birine sorması gerektiğini belirler.

Mod	Nerede çalışır	Ne yapar
Server modu	Production'ın yanında	Incident'ları inceler, kanıtlarıyla raporlar
Geliştirici modu	Bir geliştiricinin terminalinde	Kodu okur, düzenler, kontrolleri çalıştırır ve commit atar; her düzenlemeyi bir kişi onaylar

Server modu

Server modunda ivralo servisinizin yanında çalışır. Investigator, bir incident'ın kanıtlarını (log'lar, deploy kaydı, metrikler ve alarmın kendisi) servisin repo'suyla birlikte okur. Sonra her iddiasını kanıttan ya da koddan bir satıra dayandıran bir rapor yazar.

Bir inceleme üç yoldan başlayabilir:

Terminalden ivralo incident ile.
ivralo serve'ün loopback üzerinde, token arkasında açtığı yerel API'ye POST /incident ile.
Bir Alertmanager ya da PagerDuty webhook'uyla; webhook bir job'a dönüşür. Aynı alarm iki kez gelse de tek job açılır.

Investigator hiçbir şeyi düzenlemez. Server modunda bir istek kod değişikliği gerektiriyorsa ivralo kendi branch'inde taslak bir PR açabilir; ama merge etmez, deploy da etmez.

Adım adım anlatımı Server modu ve incident'lar sayfasında bulabilirsiniz.

Geliştirici modu

Varsayılan mod geliştirici modudur; ayrıntıları Repo'da çalışmak sayfasında. Bir repo'nun içinde ivralo komutunu çalıştırırsınız. Ana ajan kodu okur, düzenler, projenin kendi kontrollerini çalıştırır ve commit atar; iş temiz bir bağlam ya da daha dar bir yetki gerektirdiğinde uzmanlarla birlikte çalışır.

Her düzenleme bir diff olarak gösterilir ve onayınızı bekler: tek seferlik, o tur için ya da oturum boyunca.
Shell komutları izin ver, sor, reddet politikasından geçer.
Birden fazla Code Engineer aynı anda, her biri kendi git worktree'sinde çalışabilir.
Başında kimsenin olmadığı bir çalıştırmaya (pipe, job, zamanlanmış iş) soru sormayı gerektiren hiçbir yetki verilmez.

Her model, kendi ağınız

ivralo hangi modeli gösterirseniz onunla çalışır: Ollama üzerinden yerel bir model, şirketinizin kendi OpenAI uyumlu endpoint'i ya da barındırılan bir API. Barındırılan bir model her açılışta açıkça bildirilir. Incident kanıtı da, siz tanımlayıcıları maskeleyerek izin vermedikçe böyle bir modele gönderilmez.

Oturumlar, çalıştırma geçmişi, uzun süreli bellek ve bilgi dizini kendi PostgreSQL'inizde tutulur. Siz göndermedikçe makineden hiçbir şey çıkmaz.

Belgeler ve veri

ivralo işin döndüğü dosyaları da okuyup yazar: Word belgeleri, sunumlar, tablolar ve PDF'ler, grafikler, CSV ve Excel dosyaları üzerinde SQL, taranmış belgelerden metin. Bu taraf da aynı motoru ve aynı onayları kullanır.

Nasıl edinilir

Henüz herkese açık bir kurulum yok. Bize yazın, kurulumu birlikte yapalım.