AiHummer
Аԥсшәа▾
Аиалаҵара
v1.0.x▾
v1.0.xstable
{ }Swagger
Архитектура/Асайдкарқәа

Асайдкарқәа

v1.0.x · ирҿыцуп 2026-06-26

Иарбоу алшарақәа — абжьы, авидео, веб-аԥшаара, иаheadless абраузер — агейтуэй ахаҭа ахәҭам. Уи иауеит асайдкарқәа ҳасабла: ихәыҷу, ихазхаҭу HTTP-маҵурақәа агейтуэй URL ала иауланахо. Иаауазаалак асайдкар иарадоуп насгьы алокалуп: азакәызаалак иарбоу амалратә паид API уи аҩныҟа ыҟам.

Асайдкар иарбану

Асайдкар хазхаҭу апроцессуп HTTP API аанарԥшуа. Агейтуэй уи азакәызаалак иадхалаӡом ма иаԥроцесс аҿы иауӡом — иара уара иаиқәыршәоу URL иаҿаҳәоит. Иаауазаалак асайдкар

  • иауеит хатәы systemd-юнит ала (хост-натив, аконтейнерқәа рада),
  • агейтуэй ахь иавироуп асреда аизменӡа ала, ацны
  • алокалла агейтуэй адагьаҵара иауеит, ма иҟоу аинстанс ахь иарбоит уара уаргьы иуаауазаалак ари.

Аконтракт HTTP мацара ауп азы, убри акызаҵәык аиқәыршәара иаауеит асайдкар localhost аҿы ма егьырҭ ахост аҿы иаауазаалак.

[!NOTE] Асайдкарқәа изыхәҭоуп. Алшарак иаактивтахоит уи URL аиқәыршәоу аамҭазы мацара; убри ашьҭахьҟа агейтуэй уи ада иауеит. Ари аминималтә инсталл агейтуэй акыи PostgreSQL акыи мацара иааникылоит.

Асайдкарқәеи рпортқәеи

Апорт Асайдкар Иадгылоу Изыршаахо Иавироу
8001 STT faster-whisper speech-to-text AIHUMMER_STT_URL
8002 TTS edge-tts text-to-speech AIHUMMER_TTS_URL
8003 diarize pyannote абжьыҟаҵаҩ адиаризациа AIHUMMER_DIARIZE_URL
8004 voiceclone OpenVoice V2 абжьы аклонра AIHUMMER_VOICECLONE_URL
8005 video ffmpeg авидео аилкаара AIHUMMER_VIDEO_URL
8888 SearXNG SearXNG web_search аусхк SEARXNG_URL
9222 Chrome / CDP Chrome (CDP) browser аусхк CLOAKBROWSER_CDP_URL

Абжьытә сайдкарқәа уи иарбоу-аарду апаҭ ауп: STT (:8001) аагент ахаҿ иадгылоит насгьы TTS (:8002) аҭак иацәажәоит, ҩба иарада/алокалу адвигательқәа рҿы. Адиаризациа (:8003), абжьы аклонра (:8004) ацны авидео аилкаара (:8005) иҵегь, опт-ин сайдкарқәоуп. SearXNG (:8888) web_search иадгылоит, насгьы Chrome/CDP эндпоинт (:9222) browser аусхк иадгылоит.

Асайдкарқәа равиринг

Уара агейтуэй иаауазаалак асайдкар ахь иауаԥҟоит иеиԥшу асреда аизменӡа ала. Хост-натив инсталл рзы абжьытә сайдкарқәа (STT/TTS) уара иуаиқәыршәоуп; егьырҭ иахәҭоу аамҭазы иаунакыруеит.

# 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] Иаауазаалак асайдкар URL мацара ауп азы, иуадаҟәу амаҵурақәа централизациа уауеит. Акырынтә агейтуэйқәа акызаҵәык иажәларо STT/TTS ма SearXNG аинстанс ахь иарб, хост ала акопиа аусура аҟынтә мап.

Налатла ма иажәларо рауреира

Иаауазаалак асайдкар иауеит хатәы systemd-юнит ала ахост аҿы, уи аҟынтә уи иуоперируеит егьырҭ амаҵура иеиԥшны — анадоу, аанкылара ацны алогқәа рыԥхьара агейтуэй ахазны. Уара уаргьы иуаауазаалак, абас, SearXNG ма Chrome/CDP эндпоинт, иаразнак URL убри иҟоу аинстанс ахь иауаԥҟа насгьы алокал инсталл иаԥх. Ҩба апаҭала агейтуэй абара акызаҵәыкуп: иаиқәыршәоу URL иаҿаҳәартә.

[!WARNING] browser (CDP) ацны web_search аусхкқәа аҳақь ахь иҭыҵуеит. Иазааны идоу ма иаair-gapped адеплойментқәа рҿы аэгресси иаair-gapped аиқәыршәареи иаԥхь рактивтахаара аԥхьа — агейтуэй уара иаувироу асайдкар мацара иаҿаҳәоит.

Аҩаџьара иуцо