AiHummer
Қазақша▾
КіруЖеке кабинет
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Архитектура/Сайдкарлар

Сайдкарлар

v1.2.x · жаңартылды 2026-07-05

Кейбір мүмкіндіктер — сөйлеу, видео, веб іздеу, басы жоқ браузер — сол шлюздің өзіне кірмейді. Олар ретінде іске қосылады қасындағы арбалар: қақпалық интерфейс арқылы қол жетімді кішігірім, тәуелсіз HTTP қызметтері URL бойынша. Әрбір сайдкар тегін және жергілікті: олардың ешқайсысының артында міндетті ақылы API жоқ.

Сайкар дегеніміз не

Сайдкар — HTTP API көрсететін бөлек процесс. Шлюз оны ешқашан қосып немесе процесс ішінде іске қоспайды — ол тек сіз конфигурациялаған URL мекенжайын шақырады. Әр сайдкар

  • асып кетеді өз жүйесінің systemd бірлігі (қонақ-жергілікті, контейнерлер жоқ),
  • қоршаған орта айнымалысы арқылы шлюзге қосылған және
  • қабілетті шлюздың қасында жергілікті түрде орнатылған немесе бар нәрсеге бағытталған мысал сен бұрыннан басқа жаққа жүгіріп кеттің.

Себебі келісімшарт тек HTTP болса, бүйірлік контейнер қосулы болуына қарамастан, сол конфигурация жұмыс істейді localhost немесе басқа хостта.

[!NOTE] Сайдкарлар міндетті емес — бір ерекшелік бар: веб іздеу (SearXNG) мен антидетект-браузер (CloakBrowser) қораптан шыға орнатылады. Олардың жүктемелері қол қойылған орнатқыш бандлының ішінде жеткізіледі және офлайн орнатылады. Оларды орнатқыштың --no-search және --no-browser жалаушаларымен өшіруге болады. Басқа кез келген қабілет тек оның URL мекенжайы бапталған кезде ғана белсенді; минималды орнату бұрынғыша тек шлюз плюс PostgreSQL.

Сайдкарлар және олардың порттары

Порт Сайдкар Қолдау тапқан Құзыреттер Сыммен жалғанған
8001 СТТ жылдамырақ сыбыр сөйлегенді мәтінге айналдыру AIHUMMER_STT_URL
8002 Дыбысты мәтінге айналдыру edge-tts мәтінді дауысына айналдыру AIHUMMER_TTS_URL
8005 бейне ffmpeg видеоны түсіну AIHUMMER_VIDEO_URL
8888 SearXNG SearXNG web_search құралы орнатқыш орнатады, параметр жасырын; сыртқы дана — --external-search=URL
9222 Chrome / CDP Chrome (CDP) browser құралы орнатқыш орнатады, параметр жасырын; сыртқы дана — --external-browser=URL

Дауыстық сайкарлар - қораптан шыққан жол: STT (:8001) агенттің ауысымына және TTS-ке береді (:8002) жауапты айтады, бос/жергілікті қозғалтқыштарда да. Бейне түсіну (:8005) қосымша, ерікті сайдкар болып табылады. SearXNG (:8888) арқалары web_search, және Chrome/CDP соңы (:9222) қолдайды browser құрал.

Сайдкарларды сымға қосу

Сіз шлюзді сәйкес келетін әрбір сайдкарға бағыттайсыз каталог параметрі — әкімші интерфейсінен (Басқару → Баптаулар) немесе бірге aihummer settings set. gateway.env тек Bootstrap үшін арналған және осы кілттер үшін ескерілмейді. Хост-ана тіліне орнату кезінде дауыс қосымшалары (STT/TTS) сіз үшін конфигурацияланады; веб іздеу мен браузерді орнатқыштың өзі қосады — сіз олардың мекенжайларын ешқашан орнатпайсыз және олар баптауларда көрсетілмейді; қалғандарын қажетіне қарай қосасыз.

# 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] Әр сайдкар тек URL болғандықтан, сіз ауыр қызметтерді орталықтандыра аласыз. Әр хостта көшірме іске қосудың орнына бірнеше шлюзді бір ортақ STT/TTS данасына бағыттаңыз; іздеу мен браузер үшін дәл соны орнатқыштың --external-search=URL және --external-browser=URL жалаушалары істейді.

Оларды жергілікті түрде немесе жалпы пайдалану үшін іске қосу

Әрбір сайдкар өзінің жүйелік unit-ы астында хостада жұмыс істейді, сондықтан оны кез келген басқа қызмет сияқты басқарасыз — іске қосу, тоқтату және журналдарды оқу шлюзден тәуелсіз. Егер сіз, мысалы, SearXNG немесе Chrome/CDP ұшар нүктесін бұрыннан іске қоссаңыз, орнатқышқа --external-search=URL немесе --external-browser=URL беріңіз: жергілікті көшірме орнатылмайды, ал шлюз сіздің данаңызды шақырады. Дауыс пен бейне үшін сәйкес параметрді бар данаға бағыттаңыз. Әйтеуір, шлюз үшін көрініс бірдей: оған шақыра алатын конфигурацияланған URL.

[!WARNING] Бұл browser (CDP) және web_search құралдар желіге қол жеткізеді. Өшірулі қатты немесе әуе бөлінген орналастырулар шығуды және әуе бөлінген баптауды қарастырады оларды қосар алдында — шлюз тек сіз қосқан сайдкарды шақырады.

Келесі қайда