AiHummer
Suomi▾
Kirjaudu sisäänTili
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Arkkitehtuuri/Sivuvaunut

Sivuvaunut

v1.2.x · päivitetty 2026-07-05

Jotkut toiminnot — puhe, video, verkkohaku, päättömästi toimiva selain — eivät ole osa itse porttia. Ne toimivat sivuvaunut: pienet, itsenäiset HTTP-palvelut, joihin portti pääsee käsiksi URL:n kautta. Jokainen sivuvaunu on ilmainen ja paikallinen: niiden mikään takana ei ole pakollista maksullista API:a.

Mikä sivuvaunu on

Sivuvaunu on erillinen prosessi, joka tarjoaa HTTP-rajapinnan. Portti ei koskaan linkitä sitä mukaan tai suorita sitä prosessin sisällä — se kutsuu vain määrittämääsi URL-osoitetta. Jokainen sivuvaunu

  • juoksee alla oma systemd-yksikkönsä (isäntä-kohde, ei säilöjä),
  • on kytketty porttihubiin ympäristömuuttujan kautta, ja
  • voi olla asennettuna natiivisti portin viereen tai osoitettuna olemassa olevaan esimerkki sinä juokset jo muualle.

Koska sopimus on pelkästään HTTP, sama määritys toimii riippumatta siitä, onko sivuvaunu päällä. localhost tai toisessa isännässä.

[!NOTE] Sivuvaunut ovat valinnaisia — yhtä poikkeusta lukuun ottamatta: verkkohaku (SearXNG) ja anti-detect-selain (CloakBrowser) asennetaan valmiiksi. Niiden paketit toimitetaan allekirjoitetun asennusnipun sisällä ja asennetaan offline-tilassa. Poista ne käytöstä asentajan lipuilla --no-search ja --no-browser. Jokainen muu ominaisuus on aktiivinen vain, kun sen URL-osoite on määritetty; minimiasennus on edelleen pelkkä portti ja PostgreSQL.

Sivuvaunut ja niiden portit

Satama Sivuvaunu Tuettu Voimat Johdotettu
8001 STT nopeampi-kuiskaus puheesta tekstiin AIHUMMER_STT_URL
8002 TTS edge-tts teksti puheeksi AIHUMMER_TTS_URL
8005 video ffmpeg videon ymmärtäminen AIHUMMER_VIDEO_URL
8888 SearXNG SearXNG se web_search työkalu asentajan asentama, asetus piilotettu; ulkoinen instanssi — --external-search=URL
9222 Chrome / CDP Chrome (CDP) se browser työkalu asentajan asentama, asetus piilotettu; ulkoinen instanssi — --external-browser=URL

Äänilisäosat ovat valmiiksi saatavilla oleva reitti: STT (:8001) syöttää agentille vuoron ja TTS:n (:8002) sanoo vastauksen, sekä ilmaisilla/paikallisilla moottoreilla. Videon ymmärtäminen (:8005) on ylimääräinen, valinnainen sivuvaunu. SearXNG (:8888) selkää web_search, ja Chrome/CDP-päätepiste (:9222) tukee browser työkalu.

Sivuvaunujen sähköistys

Suunnistat portin jokaista sivuvaunua kohti vastaavalla luettelon asetus — hallinnon käyttöliittymästä (Hallinta → Asetukset) tai kanssa aihummer settings set. gateway.env on pelkästään bootstrapia varten ja sitä ei oteta huomioon näiden avainten osalta. Isäntäympäristöön asennettaessa äänilisäosat (STT/TTS) on konfiguroitu sinulle; verkkohaun ja selaimen kytkee asentaja itse — et koskaan aseta niiden osoitteita, eivätkä ne näy asetuksissa; muut otat käyttöön tarpeen mukaan.

# Ääni sisään/ulos (asentaja määrittää STT:n/TTS:n automaattisesti)
aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings set AIHUMMER_TTS_URL http://127.0.0.1:8002

# Valinnainen video-sivuvaunu
aihummer settings set AIHUMMER_VIDEO_URL http://127.0.0.1:8005

[!TIP] Koska jokainen sivuvaunu on vain URL-osoite, voit keskittää raskaat palvelut. Osoita useita portteja yhteen jaettuun STT/TTS-instanssiin sen sijaan, että ajaisit kopion joka isännällä; haun ja selaimen osalta asentajan liput --external-search=URL ja --external-browser=URL tekevät saman.

Ajetaan ne natiivisti tai jaettuna

Jokainen sivuvaunu toimii oman systemd-yksikkönsä alla isäntäkoneessa, joten sitä käytetään kuten mitä tahansa muuta palvelua — käynnistä, pysäytä ja lue lokit riippumatta portista. Jos sinulla on jo esimerkiksi SearXNG- tai Chrome/CDP-päätepiste käynnissä, anna asentajalle --external-search=URL tai --external-browser=URL: paikallista kopiota ei asenneta, ja portti kutsuu sen sijaan sinun instanssiasi. Äänen ja videon osalta osoita vastaava asetus olemassa olevaan instanssiin. Kummassakin tapauksessa portin näkymä on identtinen: konfiguroitu URL, jota se voi kutsua.

[!WARNING] Se browser (CDP) ja web_search työkalut ottavat yhteyttä verkkoon. Päällä kovetetut tai ilmarajatut käyttöönotot tarkistavat ulosmenevän liikenteen ja ilmarajatun asetuksen ennen niiden ottamista käyttöön — portti kutsuu vain sivujuoksua, jonka olet kytkenyt.

Minne seuraavaksi