Sidecar-lar — AiHummer Sənədlər

Bəzi imkanlar — nitq, video, veb axtarış, başsız brauzer — gateway-in özünün bir hissəsi deyil. Onlar sidecar-lar kimi işləyir: gateway-in URL ilə əldə etdiyi kiçik, müstəqil HTTP xidmətləri. Hər sidecar pulsuz və lokaldır: onların heç birinin arxasında məcburi ödənişli API yoxdur.

Sidecar nədir

Sidecar HTTP API təqdim edən ayrı bir prosesdir. Gateway onu heç vaxt daxilə bağlamır və ya proses içində işlətmir — o sadəcə konfiqurasiya etdiyiniz URL-i çağırır. Hər sidecar

öz systemd vahidi altında işləyir (host-native, konteyner yoxdur),
gateway-ə mühit dəyişəni vasitəsilə qoşulur, və
gateway-in yanında native quraşdırıla bilər, ya da başqa yerdə artıq işlətdiyiniz mövcud instansiyaya yönəldilə bilər.

Müqavilə sadəcə HTTP olduğu üçün, sidecar localhost-da və ya başqa hostda olsa belə eyni konfiqurasiya işləyir.

[!NOTE] Sidecar-lar opsionaldır. İmkan yalnız onun URL-i konfiqurasiya edildikdə aktiv olur; ona qədər gateway onsuz işləyir. Bu, minimal quraşdırmanı yalnız gateway plus PostgreSQL-də saxlayır.

Sidecar-lar və onların portları

Port	Sidecar	Əsası	Gücləndirir	Qoşulma
8001	STT	faster-whisper	nitqdən-mətnə	`AIHUMMER_STT_URL`
8002	TTS	edge-tts	mətndən-nitqə	`AIHUMMER_TTS_URL`
8003	diarize	pyannote	danışan diarizasiyası	`AIHUMMER_DIARIZE_URL`
8004	voiceclone	OpenVoice V2	səs klonlaması	`AIHUMMER_VOICECLONE_URL`
8005	video	ffmpeg	video anlama	`AIHUMMER_VIDEO_URL`
8888	SearXNG	SearXNG	`web_search` aləti	`SEARXNG_URL`
9222	Chrome / CDP	Chrome (CDP)	`browser` aləti	`CLOAKBROWSER_CDP_URL`

Səs sidecar-ları qutudan-çıxan yoldur: STT (:8001) agent dövrünü qidalandırır və TTS (:8002) cavabı danışır, hər ikisi pulsuz/lokal mühərriklərdə. Diarizasiya (:8003), səs klonlaması (:8004) və video anlama (:8005) əlavə, opt-in sidecar-lardır. SearXNG (:8888) web_search-i dəstəkləyir, və Chrome/CDP son nöqtəsi (:9222) browser alətini dəstəkləyir.

Sidecar-ların qoşulması

Gateway-i hər sidecar-a uyğun mühit dəyişəni ilə yönəldirsiniz. Host-native quraşdırma üçün səs sidecar-ları (STT/TTS) sizin üçün konfiqurasiya olunur; qalanını lazım olduqca aktivləşdirirsiniz.

# 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] Hər sidecar sadəcə URL olduğu üçün, ağır xidmətləri mərkəzləşdirə bilərsiniz. Host üzrə bir nüsxə işlətmək əvəzinə bir neçə gateway-i paylaşılan bir STT/TTS və ya SearXNG instansiyasına yönəldin.

Onları native və ya paylaşılan işlətmək

Hər sidecar hostda öz systemd vahidi altında yaşayır, ona görə də onu hər hansı başqa xidmət kimi idarə edirsiniz — gateway-dən asılı olmayaraq müstəqil olaraq başladın, dayandırın və logları oxuyun. Əgər deyək ki, artıq bir SearXNG və ya Chrome/CDP son nöqtəsi işlədirsinizsə, sadəcə URL-i həmin mövcud instansiyaya təyin edin və lokal quraşdırmanı tamamilə keçin. Hər iki halda gateway-in baxışı eynidir: çağıra biləcəyi konfiqurasiya edilmiş URL.

[!WARNING] browser (CDP) və web_search alətləri şəbəkəyə çıxır. Sərtləşdirilmiş və ya hava-boşluqlu tətbiqlərdə onları aktivləşdirməzdən əvvəl çıxış (egress) və hava-boşluqlu parametri nəzərdən keçirin — gateway yalnız sizin qoşduğunuz sidecar-ı çağırır.

Növbəti hara

Səsin və brauzer alətinin bir dövrdə necə istifadə olunduğu: Gateway və dövr mühərriki.
Minimal sərt asılılıq (PostgreSQL) və qalan hər şeyin opt-in olması: Gateway və dövr mühərriki.