AiHummer
Кыргызча▾
Кирүү
v1.0.x▾
v1.0.xstable
{ }Swagger
Архитектура/Сайдкарлар

Сайдкарлар

v1.0.x · жаңыланды 2026-06-26

Кээ бир мүмкүнчүлүктөр — сүйлөө, видео, веб издөө, баш-чексиз браузер — шлюздун өзүнүн бөлүгү эмес. Алар сайдкарлар катары иштейт: шлюз URL аркылуу жетилген кичинекей, көз каранды эмес HTTP кызматтары. Ар бир сайдкар акысыз жана локалдык: алардын эч биринин артында милдеттүү акылуу API жок.

Сайдкар деген эмне

Сайдкар — HTTP API чыгарган өзүнчө процесс. Шлюз аны эч качан туташтырбайт же процесстин ичинде иштетпейт — ал жөн гана сиз конфигурациялаган URLди чакырат. Ар бир сайдкар

  • өзүнүн systemd блогунда иштейт (хост-нативдик, контейнерлер жок),
  • айлана-чөйрө өзгөрмөсү аркылуу шлюзга туташтырылган, жана
  • шлюздун жанына нативдик орнотулушу мүмкүн, же сиз башка жерде мурунтан иштеткен бар инстанска багытталышы мүмкүн.

Келишим жөн гана HTTP болгондуктан, ошол эле конфигурация сайдкар localhostто болсо да, башка хостто болсо да иштейт.

[!NOTE] Сайдкарлар кошумча. Мүмкүнчүлүк анын URLи конфигурацияланганда гана активдүү; ага чейин шлюз ансыз иштейт. Бул минималдуу орнотууну жалаң шлюз плюс PostgreSQLге кармайт.

Сайдкарлар жана алардын порттору

Порт Сайдкар Колдоого алынган Кубаттайт Туташтырылган
8001 STT faster-whisper сүйлөө-тексте AIHUMMER_STT_URL
8002 TTS edge-tts текст-сүйлөөгө 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 инструменттери тармакка кайрылат. Бекемделген же абага-боштук жайылтууларда аларды иштетер алдында чыгуу трафигин жана абага-боштук жөндөөсүн карап чыгыңыз — шлюз сиз туташтырган сайдкарды гана чакырат.

Андан ары кайда