Dokümantasyon / Kurulum

ivralo doctor

ivralo doctor, ivralo'nun ihtiyaç duyduğu her şeyi bölüm bölüm kontrol eder ve her sorunu düzeltmesiyle birlikte tek satırda verir. Kurulumdan sonra, yükseltmeden sonra ve modeli suçlamadan önce çalıştırın.

Çalıştırmak

ivralo doctor

Hiçbir seçenek almaz. Diğer bütün komutların okuduğu ayarları okur ve hiçbir şeyi değiştirmez. Tek istisna şu: ivralo'nun oluşturduğu bir PostgreSQL cluster'ı durmuşsa, herhangi bir ivralo komutu nasıl başlatıyorsa doctor da onu öyle başlatır. Çalışma alanına girilemese bile çalışır, çünkü teşhis ettiği şeylerden biri de budur.

ivralo init, az önce yazdığı ayarlar üzerinde aynı raporu çalıştırarak biter.

Bir satırı okumak

postgres
    ok  postgres from  docker compose (the ivralo-postgres container)
  fail  reachable  postgresql+psycopg://ivralo:***@127.0.0.1:5432/ivralo - OperationalError: (psycopg.OperationalError) connection failed: ...
        start it with: docker compose up -d

İşaret	Anlamı
`ok`, yeşil	Kontrol geçti. Etiketten sonraki metin ne bulunduğunu söyler.
`fail`, kırmızı	Kontrol başarısız oldu. Altındaki girintili gri satır düzeltmedir.
Tek başına girintili gri bir satır	Bir not: bilerek kapatılmış, yapılandırılmamış ya da bilmenizde fayda olan bir şey. Raporu hiçbir zaman başarısız yapmaz.

doctor'ın raporunda sarı yoktur: bir satır ya geçer ya kalır, geri kalan her şey nottur. Görmüş olabileceğiniz sarı hint satırları ivralo init'e aittir; init, şu an bir şey yapmanızı gerektirmeyen ama neler yapabileceğinizi gösteren adımları böyle işaretler.

Sonuç ve çıkış kodu

Rapor şu iki satırdan biriyle biter:

Everything checks out. Start with: ivralo
Some checks failed. Fix those first.

Bütün satırlar geçerse çıkış kodu 0, herhangi biri başarısız olursa 1'dir. Böylece bir script ya da bir deploy adımı ivralo doctor'ı bir kapı olarak kullanabilir. Notlar çıkış kodunu hiçbir zaman değiştirmez.

Bölümler

Bölümler bu sırayla gelir. Yapılandırmadığınız bir özellik için bunu belirten tek bir not çıkar, asla kırmızı bir satır değil.

Makine ve depolama

Bölüm	Neyi kontrol eder
`environment`	Python; ana dizin ve nasıl bulunduğu (`IVRALO_HOME` ya da başlattığınız checkout); kod kökü ve onun skill rafı; hangi `.env` dosyalarının okunduğu; çalışma alanının yazılabilir olup olmadığı, güvenilip güvenilmediği ve bir git repo'su olup olmadığı; `IVRALO.md` ya da `AGENTS.md`. Kurulu sürüm, ana dizindeki raftan daha fazla skill getiriyorsa bunu belirtir.
`private files`	`.env`, `google-token.json` ve `api-token` dosyalarını yalnızca sahibinin okuyabildiğini.
`postgres`	Veritabanının nereden geldiğini (Docker, sizin verdiğiniz bir URL ya da ivralo'nun oluşturduğu bir cluster), cevap verip vermediğini ve portunun hangi adreste açık olduğunu. Oluşturulmuş bir cluster için ayrıca veri dizini, port ve `pg_dump` satırı (PostgreSQL).
`disk`	Çalışma alanının bulunduğu diskteki boş alanı, dosya geçmişinin ve veritabanının boyutunu.
`libraries`	Motorun kullandığı her kütüphanenin import edilebildiğini.

Modeller

Bölüm	Neyi kontrol eder
`ollama`	Bir rol ya da embedder Ollama üzerinde çalışıyorsa: sunucuyu, kullanılan tag'lerin çekilip çekilmediğini ve yüklü her modelin ne kadarının GPU'da durduğunu.
`providers`	Kullanılan her barındırılan sağlayıcıyı: SDK'sını, anahtarını ve makineden neyin çıktığını. OpenAI uyumlu bir endpoint'ten model listesi istenir; gateway listelemeye izin vermiyorsa tek token'lık bir completion ile karar verilir. Ayrıca incident kanıtı açısından hangi modellerin barındırılan sayıldığını gösterir.
`context`	Yapılandırılmış bağlam penceresini Ollama'nın gerçekte kullandığıyla karşılaştırır.

Skill'ler, bilgi ve araçlar

Bölüm	Neyi kontrol eder
`skills`	Doğrulanmış ve lint'ten geçmiş iki rafı, yüklenirken onarılan dosyaları ve her skill'in sahibini.
`mcp`	`mcp.json`'da tanımlı sunucuları. Bağlantılar yalnızca istendiğinde, `ivralo mcp test <name>` ile denenir.
`knowledge`	Bilgi dizinini: `vector` eklentisini, gerçek bir embedding isteğini ve döndürdüğü boyutu, dizinde neler olduğunu.
`web`	Web araçlarını: arama kütüphanelerini, tarayıcıyı, yapılandırılmışsa SearXNG'yi. Sunucuda kapalıdır.
`ocr`	Taranmış belgeler için `docling` komutunu ve dillerini.

Entegrasyonlar

Bölüm	Neyi kontrol eder
`tracing`	Span'lerin dışarı aktarılıp aktarılmadığını, aktarılıyorsa nereye.
`database`	Ekibin sorgulaması için tanımladığınız her veritabanı bağlantısını. ivralo'nun kendi PostgreSQL'i bu değildir; o yukarıdaki `postgres` bölümündedir.
`terminal`	Terminalin resim gösterip gösteremediğini ve tuş atamalarınızı.
`photos`	Stok fotoğraf araçlarının bağımlılıklarını.
`mail`, `notify`	E-posta hesabını ve kimlere yazılabileceğini; Telegram ya da Slack kanalını.
`google`, `github`	Google girişini ve servislerini; GitHub token'ını, `gh` komutunu ve GitHub Clerk'ü.
`forge`	ivralo'nun git kimliğini, forge kimlik bilgisini ve kime ait olduğunu, ayrıca modu (Sunucuya kurulum).
`schedules`	Her zamanlanmış isteği, işletim sisteminin zamanlayıcısında kayıtlı olup olmadığını ve son çalışmasını.

Kod çalıştırmak

Bölüm	Neyi kontrol eder
`python runtime`	Worker'ın sandbox'ını: süreci, sınırlarını, temizlenmiş ortamını.
`permissions`	Ana dizinin ve repo'nun `permissions.json` dosyalarını, her birinin özetiyle, ve birleştirilmiş shell politikasını.
`egress`	Egress politikasını: her yerde neyin reddedildiğini, host listelerinizi ve her çıkışın (web, tarayıcı, worker, shell) hakkında karar verilmemiş bir host'la ne yaptığını.
`language servers`	`IVRALO.md`'de tanımlı her sunucuyu: `PATH`'te olup olmadığını, başlamasına izin verilip verilmediğini ve cevap verip vermediğini.
`api`	Yerel API'yi: token dosyasını ve `ivralo serve`'ün kendi portunda çalışıp çalışmadığını, kapalı olup olmadığını ya da portu başka bir şeyin tutup tutmadığını.
`code index`	Repo'nun kod dizininin neyi yansıttığını ve neler içerdiğini; tanımlı bir dil sunucusu hiç sembol üretmediyse satır kırmızıdır.
`changesets`	Açık mı kapalı mı olduğunu ve hâlâ bekleyen hazırlanmış bir changeset olup olmadığını.
`evidence`	`IVRALO.md`'deki `# Evidence` bölümünün aramaya açtığı klasörleri ve her birinin eklediği dosyaları. Var olamayacak bir klasör tanımlanmışsa satır kırmızıdır.
`capabilities`	Profili, yetki tablosunu, her uzmanın yetkilerini, temel yetkileri ve ana ajanın sahip olduklarını.
`session`	Parolası gizlenmiş veritabanı URL'sini, şemayı, instance sınırlarını, etkin oturumu ve bellek kaydı sayısını.

Bir şey kırmızı çıktığında

Satırları sırayla düzeltin: kırmızı bir postgres ya da environment satırı çoğu zaman aşağıdaki kırmızı satırların da sebebidir. Başarısız her satırın altındaki gri satır, neyi çalıştırmanız ya da değiştirmeniz gerektiğini söyler. Sonra ivralo doctor'ı yeniden çalıştırın.