AiHummer
Türkmençe▾
GirmekŞahsy kabinet
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Arhitektura/Sidecarlar

Sidecarlar

v1.0.x · täzelendi 2026-07-05

Käbir mümkinçilikler — gürlemek, wideo, web gözleg, başsyz brauzer — özüniň gapysyň bir bölegi däl. Olar hökmünde işleýärler jäkli motosikl: kiçi, garaşsyz HTTP hyzmatlary, girelgäniň ýetýän ýerine URL boýunça. Her bir sajy erkin we ýerli: olaryň hiç biriniň arkasynda hökmany tölenmeli API ýok.

Säýgäni näme

Daşky motor HTTP API-ni açýan aýratyn bir prosesdir. Gapylama ony hiç haçan birleşdirmeýär ýa-da iş prosesinde işe goýmaýar — ol diňe siziň konfigurasiýa edýän URL-iňizi çagyrýar. Her daşky motor

  • aşakda işleýär öz systemd bölümi (hoş-naýsy, konteýner ýok),
  • daşky gurşaw üýtgeýji arkaly gapy enjamyna birikdirilen we
  • bolup bilýär gapy bilen beýik öňünde ýerlikli ýagdaýda oturdylan ýa-da bar bolan bir zada gönükdirilen mysal sen eýýäm başga ýere gaçýarsyň.

Kontrakt diňe HTTP bolany üçin, gapma-garşy tarap hereketde bolsa-da, şol bir sazlama işleýär localhost ýa-da başga bir myhmançyda.

[!NOTE] Yan maşynlar islege baglydyr — bir kadadan çykma bilen: web gözleg (SearXNG) we anti-detekt brauzeri (CloakBrowser) gutudan çykan badyna gurnalýar. Olaryň ýükleri gol çekilen gurnaýjy bandlynyň içinde gelýär we oflaýn gurnalýar. Olary gurnaýjynyň baýdaklary bilen öçüriň: --no-search we --no-browser. Beýleki her bir mümkinçilik diňe onuň URL-i sazlananda işjeň bolýar; minimal gurnama henizem diňe gateway bilen PostgreSQL-den ybarat.

Yan arabalary we olaryň portlary

Port Sidekar Goldawlanýar Kuwatlar Simli
8001 STT hasapyn-düşünmek sözden-tekste AIHUMMER_STT_URL
8002 TTS edge-tts teksten-ses AIHUMMER_TTS_URL
8005 wideo ffmpeg wideo düşünmek AIHUMMER_VIDEO_URL
8888 SearXNG SearXNG şu web_search gural gurnaýjy tarapyndan gurnalýar, sazlama gizlin; daşarky nusga — --external-search=URL
9222 Chrome / CDP Chrome (CDP) şu browser gural gurnaýjy tarapyndan gurnalýar, sazlama gizlin; daşarky nusga — --external-browser=URL

Ses beýlekileri gurnama taýýar ýoldur: STT (:8001) agentiň ädimini we TTS-i iýmitlendirýär (:8002) jogaby aýdýar, öňbaryjy/ýerli motorlarda hem. Wideo düşünmek (:8005) goşmaça, isleme boýunça goşulýan gapyl. SearXNG (:8888) yzy web_search, we Chrome/CDP nokady (:9222) goldaýar browser gurall.

Ojag baglamalary

Siz gapyny her bir tarap öňündäki eýýäm gabat gelýän bilen nokatlaýarsyňyz katalog sazlamasy — administrasiýa UI-dan (Dolandyryş → Sazlamalar) ýa-da bilen aihummer settings set. gateway.env diňe bootstrap üçin we bu açarlar üçin göz öňünde tutulmaýar. Myhman-sahypa gurmak üçin ses kömekçileri (STT/TTS) siziň üçin sazlanýar; web gözlegi we brauzeri gurnaýjynyň özi birikdirýär — siz olaryň salgylaryny hiç haçan goýmaýarsyňyz we olar sazlamalarda görkezilmeýär; galanlaryny bolsa zerur bolan ýagdaýynda ýandyrýarsyňyz.

# Voice in/out (auto-configured by the installer for 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

# Optional video sidecar
aihummer settings set AIHUMMER_VIDEO_URL http://127.0.0.1:8005

[!TIP] Her bir saýtkar diňe bir URL bolany üçin, agramly hyzmatlary merkezileşdirip bilersiňiz. Her host üçin bir nusga işletmegiň ýerine, birnäçe gateway-i bir paýlaşylan STT/TTS nusgasyna gönükdiriň; gözleg we brauzer üçin gurnaýjynyň --external-search=URL we --external-browser=URL baýdaklary şol bir işi edýär.

Olary özbaşdak ýa-da paýlaşylan görnüşde işletmek

Her bir sidecar öz öýjärligiňdäki systemd birlikde ýaşaýar, şonuň üçin ony başga bir hyzmat ýaly işleýärsiňiz — başlangyç, durduryş we gündelik ýazgylary gateway-den garaşsyz okap bilersiňiz. Mysal üçin, eýýäm SearXNG ýa-da Chrome/CDP nokadyny işledýän bolsaňyz, gurnaýja --external-search=URL ýa-da --external-browser=URL beriň: ýerli nusga gurnalmaýar we gateway siziň nusgaňyzy çagyrýar. Ses we wideo üçin degişli sazlamany bar bolan nusga gönükdiriň. Her ýagdaýda gapynyň gözi birmeňzeş: çagyrmagy mümkin bolan sazlanylan URL.

[!WARNING] Şu browser (CDP) we web_search guralar tor bilen baglanýar. Öçürilen gatyşdyrylan ýa-da howa boşlugy bilen aýrylan ýerleşdirişlerde çykşy we howa boşlugy bilen aýrylan sazlamany barlaň olary öň işjeňleşdirmän — geçelge diňe siz birikdiren gapyny çagyrýar.

Indi nire?