AiHummer
Türkçe▾
Oturum açHesap
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Mimari/Yardımcı Bisikletler

Yardımcı Bisikletler

v1.1.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?