AiHummer
Oʻzbekcha▾
Kirish
v1.0.x▾
v1.0.xstable
{ }Swagger
Arxitektura/Sidecar'lar

Sidecar'lar

v1.0.x · yangilandi 2026-06-26

Ayrim imkoniyatlar — nutq, video, web qidiruv, headless brauzer — gateway-ning oʻzi tarkibiga kirmaydi. Ular sidecar’lar sifatida ishlaydi: gateway URL orqali murojaat qiladigan kichik, mustaqil HTTP xizmatlar. Har bir sidecar bepul va lokal: ularning hech biri ortida majburiy pullik API yoʻq.

Sidecar nima

Sidecar — bu HTTP API ni taqdim etadigan alohida jarayon. Gateway uni hech qachon oʻziga bogʻlamaydi yoki jarayon ichida ishga tushirmaydi — u shunchaki siz sozlagan URL ni chaqiradi. Har bir sidecar

  • oʻz systemd birligi ostida ishlaydi (host-native, konteynersiz),
  • gateway-ga muhit oʻzgaruvchisi orqali ulanadi, va
  • gateway yonida natively oʻrnatilishi yoki boshqa joyda allaqachon ishlatayotgan mavjud instansga yoʻnaltirilishi mumkin.

Kelishuv shunchaki HTTP boʻlgani uchun, sidecar localhost da boʻladimi yoki boshqa hostda boʻladimi, xuddi shu sozlama ishlaydi.

[!NOTE] Sidecar’lar ixtiyoriy. Imkoniyat faqat uning URL’i sozlanganda faol boʻladi; shu paytgacha gateway usiz ishlaydi. Bu minimal oʻrnatishni faqat gateway va PostgreSQL bilan cheklab qoldiradi.

Sidecar’lar va ularning portlari

Port Sidecar Asoslangan Quvvatlaydi Ulanadi
8001 STT faster-whisper nutqdan matnga AIHUMMER_STT_URL
8002 TTS edge-tts matndan nutqqa AIHUMMER_TTS_URL
8003 diarize pyannote soʻzlovchi diarizatsiyasi AIHUMMER_DIARIZE_URL
8004 voiceclone OpenVoice V2 ovoz klonlash AIHUMMER_VOICECLONE_URL
8005 video ffmpeg videoni tushunish AIHUMMER_VIDEO_URL
8888 SearXNG SearXNG web_search asbobi SEARXNG_URL
9222 Chrome / CDP Chrome (CDP) browser asbobi CLOAKBROWSER_CDP_URL

Ovoz sidecar’lari quticha ichidagi tayyor yoʻldir: STT (:8001) agent turnini oziqlantiradi va TTS (:8002) javobni gapiradi, har ikkalasi ham bepul/lokal dvigatellarda. Diarizatsiya (:8003), ovoz klonlash (:8004) va videoni tushunish (:8005) qoʻshimcha, ixtiyoriy yoqiladigan sidecar’lardir. SearXNG (:8888) web_search ni quvvatlaydi, Chrome/CDP nuqtasi (:9222) esa browser asbobini quvvatlaydi.

Sidecar’larni ulash

Gateway-ni har bir sidecar-ga mos muhit oʻzgaruvchisi bilan yoʻnaltirasiz. Host-native oʻrnatish uchun ovoz sidecar’lari (STT/TTS) siz uchun sozlangan; qolganlarini kerak boʻlganda yoqasiz.

# gateway.env — voice in/out (auto-set by the installer for STT/TTS)
AIHUMMER_STT_URL=http://127.0.0.1:8001
AIHUMMER_TTS_URL=http://127.0.0.1:8002

# Optional voice/video sidecars
AIHUMMER_DIARIZE_URL=http://127.0.0.1:8003
AIHUMMER_VOICECLONE_URL=http://127.0.0.1:8004
AIHUMMER_VIDEO_URL=http://127.0.0.1:8005

# Tool sidecars
SEARXNG_URL=http://127.0.0.1:8888
CLOAKBROWSER_CDP_URL=http://127.0.0.1:9222

[!TIP] Har bir sidecar shunchaki URL boʻlgani uchun, ogʻir xizmatlarni markazlashtirishingiz mumkin. Har bir host uchun nusxa ishlatish oʻrniga bir nechta gateway-ni bitta umumiy STT/TTS yoki SearXNG instansiga yoʻnaltiring.

Ularni natively yoki umumiy ishlatish

Har bir sidecar host’da oʻz systemd birligi ostida yashaydi, shu sababli uni boshqa har qanday xizmat kabi boshqarasiz — gateway-dan mustaqil ravishda ishga tushirish, toʻxtatish va loglarni oʻqish. Agar siz allaqachon, masalan, SearXNG yoki Chrome/CDP nuqtasini ishlatayotgan boʻlsangiz, URL’ni oʻsha mavjud instansga sozlang va lokal oʻrnatishni butunlay oʻtkazib yuboring. Har ikki holatda ham gateway-ning koʻrinishi bir xil: u chaqira oladigan sozlangan URL.

[!WARNING] browser (CDP) va web_search asboblari tarmoqqa murojaat qiladi. Mustahkamlangan yoki air-gapped joylashtirishlarda ularni yoqishdan oldin egress va air-gapped sozlamasini koʻrib chiqing — gateway faqat siz ulagan sidecar-ni chaqiradi.

Keyingi qadam qayerda