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

Сайдкарлар

v1.1.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 TTS 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 аскар

Бүйүртөк жүктөгүчтөрдү туташтыруу

Сиз шлюзду ар бир сайдкарга дал келген тарап менен көрсөтөсүз каталог жөндөмдөрү — админ UI аркылуу (Башкаруу → Багыттоолор) же менен aihummer settings set. gateway.env бул болгону bootstrap болуп саналат жана бул ачкычтар үчүн эске алынбайт. Host-native орнотуу үчүн үн кошмо програмалары (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 желектери аткарат.

Аны өзүнчө же жалпы башкаруу

Ар бир сайдкар өзүнүн systemd бирдигинде хостто жашайт, ошондуктан аны башка кызмат сыяктуу иштетесиз — баштатыңыз, токтотыңыз жана журналдарды шлюздан көз карандысыз окуй аласыз. Эгер сиз буга чейин, мисалы, SearXNG же Chrome/CDP колдонуп жатсаңыз, орноткучка --external-search=URL же --external-browser=URL бериңиз: жергиликтүү көчүрмө орнотулбайт, жана шлюз сиздин нусканы чакырат. Үн жана видео үчүн тиешелүү жөндөөнү бар болгон нускага багыттаңыз. Кандай гана жол менен болбосун, шлюздун көрүүсү бирдей: чакыра ала турган конфигурацияланган URL.

[!WARNING] Бул browser (CDP) жана web_search куралдар түйүндү байланышууга жетет. Ачык катууланган же аба процессинен ажыратылган жайгаштырылуулар чыгарууну жана аба процессинен ажыратылган жөндөөнү карап чыгуу аны иштетүүдөн мурун — эшик гана сиз туташтырган сайдкарга чалат.

Келерки кайда