Yapılandırma — AiHummer Belgeler

AiHummer bir aracılığıyla yapılandırılır ayarlar kataloğu, bir yığın çevresel değişken değil. gateway.env dır yalnızca bootstrap: veritabanı DSN’si, dinleme adresleri/portları, ana anahtar ve benzeri. Diğer tüm anahtarlar veritabanında bulunur ve çalıştırma esnasında ya da web yönetici arayüzü ile değiştirilir aihummer settings CLI. Yol gösterici kural basittir: Web UI’de ayarlanabilir her şey yapılandırılabilir — sadece ortam değişkenine bağlı değil ve sabit kodlanmış değil.

Çözünürlük sırası

Her katalog ayarı aynı şekilde çözülür, ilk eşleşme kazanır:

Veritabanı — yönetici kullanıcı arayüzü üzerinden ayarlanmış bir değer veya aihummer settings set.
Varsayılan — sürümle birlikte gelen varsayılan olarak yerleşik.

Çevre bilinçli olarak bu zincirin parçası değil: katalog anahtarları için AIHUMMER_* içinde değişken gateway.env dır görmezden gelindi, ayarlansa bile. Bu, her ayara tam olarak bir doğru kaynak verir — veritabanı — böylece bir kullanıcı arayüzü değeri, bir env dosyasındaki unutulmuş bir satır tarafından sessizce gölgelenemez.

[!NOTE] Üretimde davranışı değiştirmek için yapılandırma dosyalarını düzenlemezsiniz — değiştirmeniz gereken yönetici kullanıcı arayüzünde ayar (Yönetim → Ayarlar, aranabilir bir sayfa) veya çalıştır aihummer settings set <KEY> <VALUE> (get / list okumak için), ve bu alır o çalışma alanı için etki. Yükleyici kendisi başlangıç katalog değerlerini oluşturur veritabanına doğru aihummer settings set.

Sıcak vs yeniden başlatma gerektirir

Değiştirilen bir ayarın etkili olması, anahtara bağlıdır:

Davranış	Örnekler	Ne zaman geçerlidir
Sıcak	araç etkinleştirme, alt ajan maksimum derinliği	Çalışma zamanında tekrar oku, yeniden başlatma yok
Yeniden başlatma gereklidir	dinleme adresi, belirli hizmetlerin kablolaması	Bir sonraki ağ geçidi yeniden başlatıldığında uygulanacak

Kısayol tuşları canlı olarak yeniden okunur, bu yüzden bir aracı açıp kapatmak veya ayarlamak subagent-depth Bir sonraki turda yürürlüğe girer. Bazı yapısal anahtarlar yalnızca bir yeniden başlatmadan sonra yürürlüğe girer; yönetici kullanıcı arayüzü hangisinin hangisi olduğunu işaretler.

Bootstrap değişkenleri yalnızca ortama özel kalır

Bazı değişkenlerin ortamda bulunması gerekir çünkü ayarlar kataloğu (ve okuduğu veritabanı) mevcut olmadan önce bunlara ihtiyaç vardır. Bunlar bootstrap Değişkenler yalnızca ortam içindir ve yönetici kullanıcı arayüzünde görünmez:

Değişken	Neden bootstrap?
`AIHUMMER_DATABASE_URL`	Herhangi bir DB destekli ayar okunmadan önce DB mevcut olmalıdır.
`AIHUMMER_DB_APP_URL`	RLS’yi aktifleştiren sınırlı rol DSN.
`AIHUMMER_MASTER_KEY`	base64-32 byte; beklemede sırları açar / kasa / BYOK.
`AIHUMMER_GATEWAY_ADDR`	Genel dinleme adresi (varsayılan `:8780`) — API, eşleştirme, WS/SSE, gelen ve uygulama/cüzdan vekili.
`AIHUMMER_WEBUI_ADDR`	Özel yönetici Web UI dinleme adresi (varsayılan `:8781`), kökünde servis edildi `/`; ayarla `0` devre dışı bırakmak.
`AIHUMMER_BLOB_DIR`	Blob/medya dizininin dosya sistemi yolu — başlatmada gerekli.
`AIHUMMER_OIDC_ISSUER`	Korur `/v1/admin/*` UI güvenilir olmadan önce.

Telemetry OTLP uç noktası gibi Ops kablolaması aynı önyükleme kategorisine girer. Bu kısa listedeki dışında kalan her şey bir katalog anahtarıdır: veritabanında yaşar ve env onun için göz ardı edilir.

[!WARNING] Tutmak AIHUMMER_MASTER_KEY güvenli ve yedekli ayrı ayrı veritabanınızdan yedek. Kimlik bilgisi deposunun şifresini çözer; onu kaybederseniz şifrelenmiş sırları kaybedersiniz kurtarılamaz.

Yapılandırma dosyası

Ev sahibi-yerel kurulumlar için, bootstrap ortamı sistemd ünitesinin yüklediği tek bir dosyada bulunur:

~/.aihummer/etc/gateway.env

Bu dosyayı düzenle sadece bootstrap değerleri için, sonra değişiklikleri uygulamak için ağ geçidi hizmetini yeniden başlatın:

# ~/.aihummer/etc/gateway.env (excerpt)
AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer
AIHUMMER_MASTER_KEY=base64-32-bytes...
AIHUMMER_GATEWAY_ADDR=:8780
AIHUMMER_WEBUI_ADDR=:8781
AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main

systemctl restart aihummer-gateway

Bu başlatma anahtarlarının ötesindeki her şey — ajanlar, araçlar, bellek modu, akıl yürütme stratejileri, bütçeler, güvenlik önlemleri ve diğerleri — yönetici kullanıcı arayüzü ayarlarından (veya aracılığıyla) yönetilir aihummer settings), bu dosyadan değil: env bu anahtarlar için yok sayılır.

İsteğe bağlı kablolama

Birçok özellik, onları bir destek hizmetine yöneltmediğiniz sürece kapalıdır. Tüm bu anahtarlar katalog ayarlarıdır (DB’de bulunurlar): bunları yönetici kullanıcı arayüzünde ayarlayın (Yönetim → Ayarlar) veya CLI ile; onları içine koymak gateway.env hiçbir şey yapmaz — env onlar için göz ardı edilir. Paketten kurulan yan araçlar (STT/TTS vb.) için kurucu değerleri veritabanına kendisi ekler.

# Wire a real model (unset → deterministic mock)
aihummer settings set AIHUMMER_LLM_PROVIDER openai
aihummer settings set AIHUMMER_LLM_MODEL gpt-4o-mini
aihummer settings set AIHUMMER_LLM_GATEWAY_URL https://api.openai.com/v1

# Enable tools by pointing at their backends

# Voice sidecars (STT/TTS auto-configured by the installer)
aihummer settings set AIHUMMER_STT_URL http://localhost:8001
aihummer settings set AIHUMMER_TTS_URL http://localhost:8002

# Real vector store + embedder (example URLs; the embedder is installed with
# --with-embedder, otherwise memory uses the lexical fallback)
aihummer settings set AIHUMMER_QDRANT_URL http://localhost:6333
aihummer settings set AIHUMMER_EMBEDDER_URL http://localhost:8080

[!TIP] Gerçek bir model asla gerekli değildir. Olmadan AIHUMMER_LLM_* kablolu, cevaplar geliyor belirleyici bir taklitten; AiHummer ayrıca ücretsiz/yerel OpenAI uyumlu çalışır uç noktalar ve isteğe bağlı BYOK ile bir Codex/ChatGPT abonelik taşıması.

Bildirimler

Yönetici arayüzü Bildirimler sayfa (“Kontrol” altında), örneğin gelen kutusundaki olayları (yönetici girişleri, mevcut/uygulanan güncellemeler, sidecar kapanıyor veya kurtarılıyor gibi) içerir ve kategori, önem derecesi ve okunmamışlara göre filtrelenebilir. Yanında bir kategori × teslimat-kanalı matrisi: etkinleştirdiğiniz her olay kategorisi için web arayüzü, e-posta, telegram ve itmek kanallar. Web UI bildirimleri yerel olarak iletilir; Telegram, “Telegram’ı Bağla” düğmesiyle (derin bağlantı) bağlanır, e-posta yalnızca destek adresi doğrulandıktan sonra etkinleşir ve push mobil uygulamada ulaşır. Kritik olaylar webui kanalında sessize alınamaz.

Sonra nereye?

Yönetici girişini kilitle: İlk giriş.
Dosyaların nerede olduğunu görün: Kurulum.
Ön koşulları kontrol edin: Gereksinimler.