Yardımcı Bisikletler

v1.2.x · güncellendi 2026-07-05

Bazı yetenekler — konuşma, video, web araması, başsız tarayıcı — geçidin kendisinin bir parçası değildir. Bunlar olarak çalışır yan arabalar: geçitin eriştiği küçük, bağımsız HTTP servisleri URL ile. Her yan araba ücretsiz ve yerel: bunların hiçbiri arkasında zorunlu ücretli bir API bulundurmamaktadır.

Yan araba nedir

Bir yan araba, bir HTTP API’si sunan ayrı bir işlemdir. Ağ geçidi onu asla bağlamaz veya işlem içinde çalıştırmaz — sadece yapılandırdığınız URL’yi çağırır. Her yan araba

altında çalışır kendi systemd birimi (ana bilgisayar-yerel, konteyner yok),
bir ortam değişkeni aracılığıyla ağ geçidine bağlıdır ve
olabilir geçide yerel olarak kurulmuş veya mevcut bir şeye yönlendirilmiş örnek Sen zaten başka bir yerde koşuyorsun.

Çünkü sözleşme sadece HTTP olduğu için, yan araba aktif olsun olmasın aynı yapılandırma çalışır localhost veya başka bir sunucuda.

[!NOTE] Yan arabalar isteğe bağlıdır — bir istisna dışında: web araması (SearXNG) ve anti-tespit tarayıcı (CloakBrowser) kutudan çıktığı gibi kurulur. Yükleri, imzalı yükleyici paketinin içinde gelir ve çevrimdışı kurulur. Bunları yükleyici bayrakları --no-search ve --no-browser ile kapatabilirsiniz. Diğer her yetenek yalnızca URL’si yapılandırıldığında aktiftir; minimal bir kurulum yine sadece geçit artı PostgreSQL’dir.

Yan arabalar ve bağlantı noktaları

Liman	Yardımcı Araç	Tarafından desteklenmiş	Güçler	Kablolanmış
8001	STT	daha hızlı fısıltı	konuşmayı metne çevirme	`AIHUMMER_STT_URL`
8002	TTS	edge-tts	metinden konuşmaya	`AIHUMMER_TTS_URL`
8005	video	ffmpeg	video anlama	`AIHUMMER_VIDEO_URL`
8888	SearXNG	SearXNG	`web_search` araç	yükleyici tarafından kurulur, ayarı gizlidir; harici örnek — `--external-search=URL`
9222	Chrome / CDP	Chrome (CDP)	`browser` araç	yükleyici tarafından kurulur, ayarı gizlidir; harici örnek — `--external-browser=URL`

Ses yan arabaları kutudan çıktığı gibi olan yol: STT (:8001) ajana dönüşü ve TTS’yi besler (:8002) cevabı hem ücretsiz/yerel motorlarda söyler. Video anlama (:8005) ek bir, isteğe bağlı yan araçtır. SearXNG (:8888) arkalar web_search, ve bir Chrome/CDP uç noktası (:9222) destekler browser araç.

Yan arabaları kablolamak

Geçidi her yan arabaya eşleşen ile yönlendiriyorsunuz katalog ayarı — yönetici kullanıcı arayüzünden (Yönetim → Ayarlar) veya ile aihummer settings set. gateway.env Sadece bootstrap içindir ve bu anahtarlar için göz ardı edilir. Host-yerel kurulum için ses yan arabirimleri (STT/TTS) sizin için yapılandırılır; web araması ve tarayıcı, yükleyicinin kendisi tarafından bağlanır — adreslerini hiçbir zaman siz ayarlamazsınız ve ayarlarda gösterilmezler; geri kalanını gerektiği gibi etkinleştirirsiniz.

# Voice in/out (auto-configured by the installer for STT/TTS)
aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings set AIHUMMER_TTS_URL http://127.0.0.1:8002

# Optional video sidecar
aihummer settings set AIHUMMER_VIDEO_URL http://127.0.0.1:8005

[!TIP] Her yan araba sadece bir URL olduğundan, ağır servisleri merkezileştirebilirsiniz. Her ana bilgisayarda bir kopya çalıştırmak yerine birden fazla geçidi paylaşılan tek bir STT/TTS örneğine yönlendirin; arama ve tarayıcı için aynı işi yükleyici bayrakları --external-search=URL ve --external-browser=URL görür.

Onları yerel olarak veya paylaşımlı çalıştırmak

Her bir yan araba (sidecar), host üzerinde kendi systemd biriminin altında çalışır, bu yüzden onu diğer servisler gibi işletirsiniz — başlatır, durdurur ve günlükleri ağ geçidinden bağımsız olarak okursunuz. Diyelim ki zaten bir SearXNG veya bir Chrome/CDP uç noktası çalıştırıyorsunuz; o zaman yükleyiciye --external-search=URL veya --external-browser=URL geçirin: yerel bir kopya kurulmaz ve geçit bunun yerine sizin örneğinizi çağırır. Ses ve video için, ilgili ayarı mevcut örneğe yönlendirin. Her iki durumda da ağ geçidinin görünümü aynıdır: çağırabileceği yapılandırılmış bir URL.

[!WARNING] browser (CDP) ve web_search araçlar ağa ulaşır. Açık sertleştirilmiş veya hava boşluklu dağıtımlar, çıkışı ve hava boşluklu ayarı gözden geçirir onları etkinleştirmeden önce — ağ geçidi yalnızca bağladığınız bir yan arabayı çağırır.

Sonra nereye?

Bir turda ses ve tarayıcı aracının nasıl kullanıldığı: Geçit ve dönüş motoru.
Minimum sert bağımlılık (PostgreSQL) ve geri kalan her şey isteğe bağlı: Geçit ve dönüş motoru.