Sidecar-лар — AiHummer Құжаттама

Кейбір мүмкіндіктер — сөйлеу, бейне, веб-іздеу, бассыз браузер — шлюздің өзінің бөлігі емес. Олар sidecar-лар ретінде жұмыс істейді: шлюз URL арқылы қол жеткізетін шағын, тәуелсіз HTTP қызметтері. Әрбір sidecar тегін әрі жергілікті: олардың ешқайсысының артында міндетті ақылы API жоқ.

Sidecar дегеніміз не

Sidecar — HTTP API ашатын бөлек процесс. Шлюз оны ешқашан өзіне жалғамайды немесе процесс ішінде іске қоспайды — ол жай ғана сіз конфигурациялаған URL-ді шақырады. Әрбір sidecar

өзінің systemd бірлігі астында жұмыс істейді (хост-туған, контейнерсіз),
шлюзге орта айнымалысы арқылы жалғанады, және
шлюздің қасында туғандай орнатылуы немесе сіз басқа жерде іске қосып жүрген бар данаға бағытталуы мүмкін.

Келісім жай ғана HTTP болғандықтан, sidecar localhost-та ма әлде басқа хостта ма — бірдей конфигурация жұмыс істейді.

[!NOTE] Sidecar-лар — қосымша. Мүмкіндік оның URL-і конфигурацияланғанда ғана белсенді; оған дейін шлюз онсыз жұмыс істейді. Бұл минималды орнатуды тек шлюз пен PostgreSQL-де сақтайды.

Sidecar-лар және олардың порттары

Порт	Sidecar	Негізі	Қуаттайды	Жалғанатын айнымалы
8001	STT	faster-whisper	сөйлеуден-мәтінге	`AIHUMMER_STT_URL`
8002	TTS	edge-tts	мәтіннен-сөйлеуге	`AIHUMMER_TTS_URL`
8003	diarize	pyannote	сөйлеушіні диаризациялау	`AIHUMMER_DIARIZE_URL`
8004	voiceclone	OpenVoice V2	дауысты клондау	`AIHUMMER_VOICECLONE_URL`
8005	video	ffmpeg	бейнені түсіну	`AIHUMMER_VIDEO_URL`
8888	SearXNG	SearXNG	`web_search` құралы	`SEARXNG_URL`
9222	Chrome / CDP	Chrome (CDP)	`browser` құралы	`CLOAKBROWSER_CDP_URL`

Дауыс sidecar-лары — қораптан-шыққан жол: STT (:8001) агент бұрылысын азықтандырады, ал TTS (:8002) жауапты айтады, екеуі де тегін/жергілікті қозғалтқыштарда. Диаризация (:8003), дауысты клондау (:8004) және бейнені түсіну (:8005) — қосымша, таңдамалы sidecar-лар. SearXNG (:8888) web_search-ты қолдайды, ал Chrome/CDP соңғы нүктесі (:9222) browser құралын қолдайды.

Sidecar-ларды жалғау

Сіз шлюзді әрбір sidecar-ға сәйкес орта айнымалысымен бағыттайсыз. Хост-туған орнату үшін дауыс sidecar-лары (STT/TTS) сіз үшін конфигурацияланады; қалғанын қажетінше қосасыз.

# 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] Әрбір sidecar жай ғана URL болғандықтан, ауыр қызметтерді орталықтандыруға болады. Әр хостқа бір көшірмеден іске қосудың орнына бірнеше шлюзді бір ортақ STT/TTS немесе SearXNG данасына бағыттаңыз.

Оларды туған немесе ортақ түрде іске қосу

Әрбір sidecar хостта өзінің systemd бірлігі астында тұрады, сондықтан сіз оны кез келген басқа қызмет сияқты басқарасыз — шлюзден тәуелсіз іске қосасыз, тоқтатасыз және журналдарын оқисыз. Егер сізде, мысалы, SearXNG немесе Chrome/CDP соңғы нүктесі әлдеқашан жұмыс істеп жатса, жай ғана URL-ді сол бар данаға орнатыңыз да, жергілікті орнатуды толығымен өткізіп жіберіңіз. Қалай болғанда да шлюздің көрінісі бірдей: ол шақыра алатын конфигурацияланған URL.

[!WARNING] browser (CDP) және web_search құралдары желіге қол созады. Қатайтылған немесе ауа-аралықты орналастыруларда оларды қоспас бұрын шығыс трафик пен ауа-аралықты баптауды қарап шығыңыз — шлюз тек сіз жалғаған sidecar-ды ғана шақырады.

Әрі қарай қайда

Дауыс пен браузер құралының бұрылыста қалай қолданылатыны: Шлюз және бұрылыс қозғалтқышы.
Минималды қатаң тәуелділік (PostgreSQL) және қалғанының бәрі таңдамалы: Шлюз және бұрылыс қозғалтқышы.