Sidelivery

# Wejście/wyjście głosowe (auto-konfigurowane przez instalator dla 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

# Opcjonalny sidecar wideo
aihummer settings set AIHUMMER_VIDEO_URL http://127.0.0.1:8005

Niektóre funkcje — mowa, wideo, wyszukiwanie w internecie, przeglądarka bez interfejsu — nie są częścią samej bramy. Działają jako **boczny wózek**: małe, niezależne usługi HTTP, do których dociera brama **przez URL**. Każdy sidecar jest **darmowy i lokalny**: za żadnym z nich nie stoi obowiązkowe płatne API. ## Co to jest wózek boczny Sidecar to oddzielny proces udostępniający API HTTP. Brama nigdy go nie łączy ani nie uruchamia w tym samym procesie — po prostu wywołuje skonfigurowany URL. Każdy sidecar - działa pod **własna jednostka systemd** (host-native, bez kontenerów), - jest połączony z bramą przez zmienną środowiskową, i - może być **zainstalowany natywnie obok bramki lub wskazany na istniejący przypadek** ty już biegasz gdzie indziej. Ponieważ kontrakt opiera się tylko na HTTP, ta sama konfiguracja działa niezależnie od tego, czy sidecar jest włączony `localhost` lub na innym hoście. > [!NOTE] > Sidecary są opcjonalne — z jednym wyjątkiem: wyszukiwanie w sieci (SearXNG) oraz > przeglądarka antydetekcyjna (CloakBrowser) są instalowane od razu, po wyjęciu z pudełka. > Ich pakiety są dostarczane w podpisanym bundlu instalatora i instalowane offline. > Wyłączysz je flagami instalatora `--no-search` i `--no-browser`. > Każda inna funkcjonalność jest aktywna tylko wtedy, gdy jej adres URL jest skonfigurowany; > minimalna instalacja to nadal tylko brama plus PostgreSQL. ## Boczne wózki i ich porty | Port | Boksykar | Wsparte przez | Moce | Połączony przewodami | |---|---|---|---|---| | 8001 | STT | szybszy-szept | mowa na tekst | `AIHUMMER_STT_URL` | | 8002 | TTS | edge-tts | tekst-na-mowę | `AIHUMMER_TTS_URL` | | 8005 | wideo | ffmpeg | zrozumienie wideo | `AIHUMMER_VIDEO_URL` | | 8888 | SearXNG | SearXNG | ten `web_search` narzędzie | instalowany przez instalator, ustawienie ukryte; instancja zewnętrzna — `--external-search=URL` | | 9222 | Chrome / CDP | Chrome (CDP) | ten `browser` narzędzie | instalowany przez instalator, ustawienie ukryte; instancja zewnętrzna — `--external-browser=URL` | Głosowe sidecary to gotowa do użycia ścieżka: STT (`:8001`) przekazuje agentowi turę i TTS (`:8002`) mówi odpowiedź, zarówno na darmowych/lokalnych silnikach. Zrozumienie wideo (`:8005`) jest dodatkowym, opcjonalnym sidecarem. SearXNG (`:8888`) plecy `web_search`, oraz punkt końcowy Chrome/CDP (`:9222`) popiera `browser` narzędzie. ## Okablowanie sidecarów Kierujesz bramę na każdy sidecar z dopasowaniem **ustawienie katalogu** — z interfejsu administracyjnego (**Zarządzanie → Ustawienia**) lub z `aihummer settings set`. `gateway.env` jest tylko dla bootstrap i jest ignorowane dla tych kluczy. Dla instalacji natywnej na hoście, voice sidecary (STT/TTS) są konfigurowane dla Ciebie; wyszukiwanie w sieci i przeglądarkę podłącza sam instalator — nigdy nie ustawiasz ich adresów i nie są one pokazywane w ustawieniach; resztę włączasz w razie potrzeby. ```bash # Wejście/wyjście głosowe (auto-konfigurowane przez instalator dla 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 # Opcjonalny sidecar wideo aihummer settings set AIHUMMER_VIDEO_URL http://127.0.0.1:8005 ``` > [!TIP] > Ponieważ każdy sidecar to tylko URL, możesz scentralizować ciężkie usługi. Skieruj > kilka bramek na jedną współdzieloną instancję STT/TTS zamiast uruchamiać kopię na > każdym hoście; dla wyszukiwania i przeglądarki to samo robią flagi instalatora > `--external-search=URL` i `--external-browser=URL`. ## Uruchamianie ich natywnie lub współdzielone Każdy sidecar działa pod własną jednostką systemd na hoście, więc obsługujesz go jak każdą inną usługę — uruchamiasz, zatrzymujesz i czytasz logi niezależnie od bramy. Jeśli już uruchamiasz, powiedzmy, SearXNG lub endpoint Chrome/CDP, przekaż instalatorowi `--external-search=URL` lub `--external-browser=URL`: żadna lokalna kopia nie zostanie zainstalowana, a brama będzie wywoływać Twoją instancję. Dla głosu i wideo skieruj odpowiednie ustawienie na istniejącą instancję. Tak czy inaczej, widok bramy jest identyczny: skonfigurowany URL, który może wywołać. > [!WARNING] > Ten `browser` (CDP) i `web_search` narzędzia kontaktują się z siecią. Włączone > przegląd wdrożeń utwardzonych lub izolowanych od sieci pod kątem wychodzącego ruchu i ustawienia izolacji od sieci > przed ich włączeniem — brama wywołuje tylko sidecara, który został podłączony. ## Dokąd dalej - Jak głos i narzędzie przeglądarki są używane w turze: [Bramka i silnik obrotowy](/pl/v1.0/architecture/gateway-turn-engine). - Minimalna twarda zależność (PostgreSQL) i wszystko inne opcjonalnie: [Bramka i silnik obrotowy](/pl/v1.0/architecture/gateway-turn-engine).