Sidecarlar — AiHummer Resminamalar

Käbir mümkinçilikler — söz, wideo, web gözleg, headless brauzer — gatewaýyň özüniň bölegi däldir. Olar sidecarlar hökmünde işleýär: gatewaýyň URL arkaly elýeterli kiçi, garaşsyz HTTP hyzmatlary. Her sidecar mugt we lokaldyr: olaryň hiç biriniň aňyrsynda hökmany tölegli API ýokdur.

Sidecar näme

Sidecar HTTP API açýan aýry prosesdir. Gateway ony hiç haçan içine baglamaýar ýa-da prosesiň içinde işletmeýär — ol diňe siziň sazlan URL-ňyzy çagyrýar. Her sidecar

öz systemd birligi astynda işleýär (host-natiw, konteýner ýok),
daşky gurşaw üýtgeýjisi arkaly gatewaýa sim baglanyşdyrylýar, we
gatewaýyň ýanynda natiw gurnalyp biler, ýa-da başga ýerde işledýän bar bolan instansyňa ugrukdyrylyp biler.

Şertnama diňe HTTP bolany üçin, şol bir konfigurasiýa sidecar localhost-da bolsun ýa-da başga hostda bolsun işleýär.

[!NOTE] Sidecarlar islege göredir. Mümkinçilik diňe onuň URL-y sazlananda işjeňdir; şoňa çenli gateway onsuz işleýär. Bu minimal gurnamany diňe gateway hem-de PostgreSQL bilen saklaýar.

Sidecarlar we olaryň portlary

Port	Sidecar	Esaslanýar	Güýçlendirýär	Sim baglanyşdyrylýar
8001	STT	faster-whisper	söz-tekste	`AIHUMMER_STT_URL`
8002	TTS	edge-tts	tekst-söze	`AIHUMMER_TTS_URL`
8003	diarize	pyannote	gepleýji diarizasiýasy	`AIHUMMER_DIARIZE_URL`
8004	voiceclone	OpenVoice V2	ses klonlamak	`AIHUMMER_VOICECLONE_URL`
8005	video	ffmpeg	wideo düşünmek	`AIHUMMER_VIDEO_URL`
8888	SearXNG	SearXNG	`web_search` guraly	`SEARXNG_URL`
9222	Chrome / CDP	Chrome (CDP)	`browser` guraly	`CLOAKBROWSER_CDP_URL`

Ses sidecarlary gutuly-çykan ýoldyr: STT (:8001) agent turnyny iýmitlendirýär we TTS (:8002) jogaby aýdýar, ikisi-de mugt/lokal hereketlendirijilerde. Diarizasiýa (:8003), ses klonlamak (:8004) we wideo düşünmek (:8005) goşmaça, islege görä sidecarlardyr. SearXNG (:8888) web_search-y goldaýar, Chrome/CDP ahyrlygy (:9222) bolsa browser guralyny goldaýar.

Sidecarlary sim baglanyşdyrmak

Siz gatewaýy her sidecara laýyk gelýän daşky gurşaw üýtgeýjisi bilen ugrukdyrýarsyňyz. Host-natiw gurnama üçin ses sidecarlary (STT/TTS) siz üçin sazlanýar; galanlaryny zerur bolşuna görä işjeňleşdirýärsiňiz.

# 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] Her sidecar diňe URL bolany üçin, agyr hyzmatlary merkezleşdirip bilersiňiz. Her hosta bir nusga işletmegiň ýerine birnäçe gatewaýy bir paýlaşylan STT/TTS ýa-da SearXNG instansyna ugrukdyryň.

Olary natiw ýa-da paýlaşylan işletmek

Her sidecar hostda öz systemd birligi astynda ýaşaýar, şonuň üçin siz ony islendik başga hyzmat ýaly işledýärsiňiz — başlatmak, togtatmak we gatewaýdan garaşsyz loglary okamak. Eger siz, aýdaly, SearXNG ýa-da Chrome/CDP ahyrlygyny eýýäm işledýän bolsaňyz, diňe URL-ny şol bar bolan instansa sazlaň we lokal gurnamany doly ötürip geçiň. Iki ýagdaýda-da gatewaýyň görnüşi şol bir: ol çagyryp bilýän sazlanan URL.

[!WARNING] browser (CDP) we web_search gurallary tora çykýar. Berkidilen ýa-da howa-üzülen gurnamalarda olary işjeňleşdirmezden ozal çykyşy we howa-üzülen sazlamany gözden geçiriň — gateway diňe siziň sim baglanyşdyran sidecaryňyzy çagyrýar.

Indiki ädim

Sesiň we brauzer guralynyň turnda nähili ulanylýandygy: Gateway we turn hereketlendirijisi.
Minimal gaty baglylyk (PostgreSQL) we islege görä galan ähli zat: Gateway we turn hereketlendirijisi.