AiHummer
Oʻzbekcha▾
KirishShaxsiy kabinet
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Arxitektura/Yon aravachalar

Yon aravachalar

v1.0.x · yangilandi 2026-07-05

Ba’zi imkoniyatlar — nutq, video, veb qidiruv, boshliqsiz brauzer — o’zlari eshikcha tarkibiga kirmaydi. Ular sifatida ishlaydi yon aravachalar: kichik, mustaqil HTTP xizmatlari, ularga gateway kiradi URL orqali. Har bir saydkarka bepul va mahalliy: ularning hech birining orqasida majburiy to‘lanadigan API yo‘q.

Sidekar nima

Sidecar alohida jarayon bo‘lib, HTTP API ni taqdim etadi. Gateway uni hech qachon bog‘lamaydi yoki jarayon ichida ishga tushirmaydi — u shunchaki siz sozlagan URL ga qo‘ng‘iroq qiladi. Har bir sidecar

  • ostida ishlaydi uning o‘z systemd birligi (mezbon-tugan, konteynerlarsiz),
  • muhit o‘zgaruvchisi orqali darvozaga ulangan va
  • bo‘lishi mumkin eshik yonida mahalliy ravishda o‘rnatilgan yoki mavjud bo‘lgan narsaga yo‘naltirilgan misol siz allaqachon boshqa joyda yugurasiz.

Chunki shartnoma faqat HTTP, shuning uchun qoʻshimcha xizmat yonida bo‘lishidan qat’i nazar, bir xil konfiguratsiya ishlaydi localhost yoki boshqa bir mezbon ustida.

[!NOTE] Sidecarlar ixtiyoriy — bitta istisno bilan: veb qidiruv (SearXNG) va anti-detekt brauzer (CloakBrowser) qutidan chiqqanidayoq o‘rnatiladi. Ularning fayllari imzolangan o‘rnatuvchi to‘plami ichida keladi va oflayn o‘rnatiladi. Ularni o‘rnatuvchining --no-search va --no-browser bayroqlari bilan o‘chiring. Boshqa har bir imkoniyat faqat uning URL manzili sozlanganda faollashadi; minimal o‘rnatish hali ham faqat gateway va PostgreSQL dan iborat.

Yon aravachalar va ularning portlari

Port Yon arava Qo‘llab-quvvatlangan Kuchlar Simlangan
8001 STT tezroq-pichir nutqdan-matnga AIHUMMER_STT_URL
8002 TTS edge-tts matnni nutqqa aylantirish AIHUMMER_TTS_URL
8005 video ffmpeg video tushunish AIHUMMER_VIDEO_URL
8888 SearXNG SearXNG bu web_search asbob o‘rnatuvchi tomonidan o‘rnatiladi, sozlama yashirin; tashqi instansiya — --external-search=URL
9222 Chrome / CDP Chrome (CDP) bu browser asbob o‘rnatuvchi tomonidan o‘rnatiladi, sozlama yashirin; tashqi instansiya — --external-browser=URL

Ovoz sidekarlari tayyor yechim yo‘lidir: STT (:8001) agentga navbat va TTS ni uzatadi (:8002) javobni aytadi, ham bepul/mahalliy vositalarda. Video tushunish (:8005) qo’shimcha, ixtiyoriy qo’shimcha modul hisoblanadi. SearXNG (:8888) orqalar web_search, va Chrome/CDP tugun nuqtasi (:9222) orqasini qo’llab-quvvatlaydi browser asbob.

Yon aravalarni simlash

Siz shluzni mos keladigan har bir sajdarga yo’naltirasiz katalog sozlamalari — admin UI orqali (Boshqaruv → Sozlamalar) yoki bilan aihummer settings set. gateway.env faqat bootstrap uchun va bu tugmalar uchun e’tiborga olinmaydi. Host-native o’rnatilishi uchun ovozli yon xizmatlar (STT/TTS) siz uchun sozlanadi; veb qidiruv va brauzerni o‘rnatuvchining o‘zi ulaydi — siz ularning manzillarini hech qachon o‘rnatmaysiz va ular sozlamalarda ko‘rsatilmaydi; qolganlarini esa siz kerak bo’lganda yoqasiz.

# 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] Chunki har bir sidecar shunchaki URL bo’lgani uchun, siz og’ir xizmatlarni markazlashtirishingiz mumkin. Har bir host uchun alohida nusxa ishga tushirish o‘rniga bir nechta gatewayni bitta umumiy STT/TTS instansiyasiga yo‘naltiring; qidiruv va brauzer uchun o‘rnatuvchining --external-search=URL va --external-browser=URL bayroqlari xuddi shu ishni bajaradi.

Ularni mahalliy yoki umumiy tarzda ishga tushirish

Har bir sidecar o‘zining systemd birlik tizimi ostida hostda yashaydi, shuning uchun uni boshqa har qanday xizmat kabi boshqarasiz — boshlash, to‘xtatish va loglarini gatewaydan mustaqil o‘qish. Agar siz allaqachon, masalan, SearXNG yoki Chrome/CDP endpointni ishga tushirgan bo‘lsangiz, o‘rnatuvchiga --external-search=URL yoki --external-browser=URL bayrog‘ini bering: lokal nusxa o‘rnatilmaydi va gateway buning o‘rniga sizning instansiyangizni chaqiradi. Ovoz va video uchun mos sozlamani mavjud instansiyaga yo‘naltiring. Har ikki holatda ham gatewayning ko‘rinishi bir xil: u chaqirishi mumkin bo‘lgan sozlangan URL.

[!WARNING] browser (CDP) va web_search asboblar tarmoqqa qoʻllaniladi. Yoʻq qotirilgan yoki havo-aloqasiz joylashtirishlar chiqishni va havo-aloqasiz sozlamani ko‘rib chiqing ularni yoqishdan oldin — darvoza faqat siz ulangan sidecarga qo’ng’iroq qiladi.

Keyingi qayerga