Gereksinimler

nivq tek bir konteyner imajı olarak dağıtılır ve tamamen on-prem ya da kendi bulutunuzda çalışır. Çalıştırmanın üç desteklenen yolu vardır — platformunuza uyanı seçin:

• Docker Compose — tek sunucu. Veri depoları dahil, çalışan bir nivq'ya ulaşmanın en hızlı yolu.
• Kubernetes — kümelenmiş ve ölçeklenen kurulumlar için Helm chart'ımız.
• Bare metal — konteyner motoru olmadan, bir Java çalışma zamanı bulunan sade bir Linux sunucusunda çalıştırılabilir JAR.

Aşağıdakiler üçü için de geçerlidir. Platforma özel adımlar yukarıdaki her sayfada.

Sunucu

Çalışma zamanı

Nasıl kurduğunuza göre şunlardan birine ihtiyacınız var:

• Docker Engine 24+ ve Docker Compose v2 — Compose yolu için.
• Helm 3 bulunan bir Kubernetes kümesi (1.27+) — Kubernetes yolu için.
• Bir Java 25 çalışma zamanı (JRE) ve oras — bare-metal yolu için. Herhangi bir Java dağıtımı uygundur (resmi imaj Eclipse Temurin kullanır); oras, JAR'ı registry'den çekmek için kullanılan küçük, bağımsız bir CLI'dır.

Veri depoları

nivq kendi meta verisini, denetim kaydını ve örüntü belleğini Postgres'te tutar; önbellek ve koordinasyon için Redis kullanır. Compose hızlı başlangıcı ikisini de gömülü getirir; Kubernetes ve bare-metal yolları ise kendinizinkini (yönetilen ya da kendi-barındırdığınız) getirmenizi bekler:

• pgvector eklentili PostgreSQL 16+. pgvector/pgvector imajı hazır gelir; eklenti mevcut olduğu sürece yönetilen bir Postgres de uygundur.
• Redis 7+ ya da Valkey. nivq standart Redis protokolünü konuştuğu için Valkey (BSD lisanslı Redis çatallaması) doğrudan yerine geçer.

Registry erişimi

nivq özel bir imaj; ghcr.io/nivorbit/images/nivq adresinden bir token'la çekersiniz. Çekmeden önce giriş yapın:

echo "<token>" | docker login ghcr.io -u <kullanıcı-adı> --password-stdin

Token'ınız yoksa Nivorbit ekibinden isteyin ya da [email protected]'a bir e-posta atın — kurulum erişiminizle birlikte gelir.

İnternete kapalı (air-gapped) ortamlarda imajı bir .tar dosyası olarak alıp doğrudan yüklersiniz; giriş gerekmez:

docker load -i nivq-0.2.4.tar

Bir LLM sağlayıcısı

Her ajan bir LLM ile akıl yürütür ve nivq, dağıtım anında bir kez ayarladığınız platform-yönetimli bir sağlayıcı üzerinde hafif iç görevleri çalıştırır. Şunlardan birine ihtiyacınız var:

• Barındırılan bir sağlayıcı için API anahtarı — OpenAI, Anthropic veya Azure OpenAI, ya da
• Tamamen air-gapped kurulumlar için Ollama ile yerel bir model.

Ajan başına sağlayıcılar daha sonra uygulamada yapılandırılır; platform sağlayıcısı ise ortam değişkenleriyle ayarlanır (bkz. Yapılandırma).

Bir lisans

Her kurulum imzalı bir lisansla çalışır. Şunlardan birini yapabilirsiniz:

• Nivorbit'ten önceden bir lisans dosyası alıp açılışta tohumlayın, ya da
• Lisanssız başlayın — nivq activation-pending açılır ve lisansı ilk çalıştırmada bir kez yüklersiniz.

Her iki durumda da Lisanslama ve etkinleştirme'ye bakın.

Ağ

• Barındırılan LLM: sağlayıcıya giden HTTPS erişimi gerekir.
• Güvenlik duvarı arkasındaki veritabanları: nivq'nun dışa giden IP'lerini beyaz listeye alın (bkz. Yapılandırma'da NIVQ_OUTBOUND_IPS).
• Air-gapped: yerel bir Ollama modeli çalıştırın ve politika hiçbir tedarikçinin başlattığı DB bağlantısına izin vermiyorsa MCP-native mod kullanın — nivq böylece kendi adına hiçbir dış çağrı yapmaz.