Орнотуу — AiHummer Документация

AiHummer хост-нативдик орнотулат. Орнотуу my.aihummer.ru жеке кабинетинен башталат: катталасыз, жеке орнотуу шилтемесин аласыз жана өз сервериңизде бир буйрукту иштетесиз. Орнотуу скрипти керектүү архитектурага ылайык кол коюлган бандлды тартып алат, бирдиктүү орнотуу тамырын ~/.aihummer астында (орноткучту иштеткен колдонуучунун үй каталогунда) жайгаштырат, systemd бирдиктерин каттайт жана керек болсо sidecar’ларды камсыздайт. Бул процессте эч жерде контейнерлер жок.

[!NOTE] Бул хост-нативдик орнотуу — systemd астында иштеген релиз tarball, Docker эмес. Шлюз, sidecar’лар жана плагиндердин ар бири өз systemd кызматы катары иштейт.

1-кадам: жеке орнотуу шилтемесин алыңыз

Жалпыга ачык орнотуу скрипти мындан ары жок — орнотуу шилтемеси жеке жана жеке кабинетте берилет:

my.aihummer.ru сайтында катталыңыз (email + пароль, каттагы 6 сандуу код менен ырастоо).
«Орнотуу» экранын ачып, «Жеке орнотуу шилтемесин алуу» баскычын басыңыз.
Кабинет жеке шилтемеңиз коюлган даяр буйрукту көрсөтөт.

Кабинеттин өзү жөнүндө кененирээк (реквизиттер, документтер, тарифтер) — Жеке кабинет барагында.

2-кадам: бир буйрук менен орнотуу

«Орнотуу» экранындагы буйрукту көчүрүп, аны серверде (Linux x86_64/arm64) иштетиңиз:

curl -fsSL "<жеке орнотуу шилтемеси>" | sudo bash

Жеке шилтеме https://my.aihummer.ru/dl/<токен>/install.sh түрүндө болот, аккаунтуңузга байланган жана 30 күн жарактуу — мөөнөтү өткөндөн кийин ошол эле экранда жөн гана жаңысын алыңыз. Мурда орнотулган инстанция мөөнөт өткөндөн кийин да өз шилтемеси аркылуу жаңырта берет.

Скрипт CPU архитектураңызды аныктайт, дал келген бандлды анын .sha256 текшерүү суммасы жана cosign .sig колу менен жүктөп алат, экөөнү тең текшерет, орнотуу тамырын ачат жана шлюз кызматын каттайт. Учурдагы релиз — Өзгөртүүлөр тизмесинде.

[!WARNING] Жеке шилтеме — дистрибутивге ачкычыңыз. Аны жарыялабаңыз: шилтемеси бар ар бир адам токендин мөөнөтү өткөнгө чейин сиздин атыңыздан бандлдарды тарта алат.

Орнотуу тамырынын түзүмү

Баары бир каталогдун — ~/.aihummer — астында жашайт: орноткучту иштеткен колдонуучунун үй каталогунда (sudo аркылуу болсо, бул root эмес, sudo’ну чакырган колдонуучу: мисалы, /home/ivan/.aihummer). Файлдар ушул колдонуучуга таандык, ал эми кызматтар анын атынан иштейт:

~/.aihummer/
├── bin/        gateway binary and the aihummer CLI
├── etc/        configuration (gateway.env)
├── share/      static assets (admin UI, widget)
├── sidecars/   optional STT/TTS/etc. services
├── plugins/    installed marketplace plugins
├── systemd/    unit files (symlinked into /etc/systemd/system)
├── state/      runtime state
├── data/       blob/media storage
└── logs/       service logs

systemd/ астында түзүлгөн systemd бирдик файлдары /etc/systemd/system/’ге symlink аркылуу байланышат, ошондуктан алар кадимки systemctl буйруктары менен башкарылат.

Root’суз орнотуу (rootless)

sudo/root укуктары милдеттүү эмес. Орнотуу буйругун sudo’суз иштетсеңиз, орноткуч rootless режимге өтөт: бирдиктер колдонуучулук systemd --user scope’унда катталат (файлдар ~/.config/systemd/user ичинде), aihummer CLI жана cosign ~/.aihummer/bin ичине түшөт, ал эми AIHUMMER_DATABASE_URL берилбесе, орноткуч орнотуу тамырынын ичинде колдонуучулук (user-mode) PostgreSQL кластерин камсыздайт. Кызматтар systemctl --user ... буйруктары менен башкарылат. Кызматтар хост жүктөлгөндө (колдонуучу кирген учурда гана эмес) башталышы үчүн lingering’ди күйгүзүңүз:

loginctl enable-linger $USER

Sidecar’ларды тандоо

Жеңил медиа sidecar’лар — STT (faster-whisper), TTS (edge-tts) жана video — кутудан чыгары эле орнотулат, суроосуз жана желексиз: «барып-келүүчү» үн дароо иштейт. Алардын каалаганын AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1 чөйрө өзгөрмөлөрү менен өчүрсө болот.

Калган sidecar’лар жөнүндө орноткуч интерактивдүү сурайт (tty’де), же аларды желектер башкарат — толук тизме:

Желек	Натыйжасы
`--with-search` / `--with-browser`	SearXNG / headless Chrome’ду суроосуз нативдик орнотот
`--external-search=URL` / `--external-browser=URL`	Орнотуунун ордуна бул URL’деги учурдагы кызматты колдонот
`--no-search` / `--no-browser`	Бул sidecar’ды калтырып кетет
`--with-embedder`	Семантикалык эмбеддерди орнотот (opt-in: PyTorch тартат — жүздөгөн МБ)

tty жок болсо жана желек берилбесе, search/browser калтырылып кетет. Эмбеддер AIHUMMER_WITH_EMBEDDER=1 өзгөрмөсү менен да күйгүзүлөт; ансыз эс лексикалык fallback-издөөдө иштейт. Интерфейс тилин AIHUMMER_LANG=ru|en аныктайт (болбосо орноткуч tty’де сурайт). PostgreSQL туташуусу tty’де суралат; интерактивдүү эмес орнотуу үчүн AIHUMMER_DATABASE_URL маанисин алдын ала бериңиз. tty’де орноткуч ошондой эле резервдик көчүрмөдөн калыбына келтирүүнү сунуштайт.

# Install the gateway with native search and embedder, without a browser
curl -fsSL "<жеке орнотуу шилтемеси>" | sudo bash -s -- \
  --with-search --with-embedder --no-browser

Sidecar’ларга URL аркылуу жетилгендиктен, сиз нативдик жана тышкыларды эркин аралаштырып, бир нече шлюзду бир ортоктош sidecar’га багыттай аласыз.

Релиз каналдары

AiHummer төрт каналда жөнөтүлөт: stable, alfa, beta жана dev. Жеке кабинеттеги жеке шилтеме stable каналын орнотот — бул бардык колдонуучулар үчүн штаттык жол.

Канал	Жеткиликтүүлүк	Обфускацияланган
stable	Жеке кабинеттеги жеке шилтеме	—
alfa	Вендор берет (тестирлөө программалары)	Ооба
beta	Вендор берет (тестирлөө программалары)	Ооба
dev	Вендор берет	Жок (обфускацияланбаган)

alfa/beta/dev каналдары ачкыч менен корголгон жана эрте тестирлөө программаларынын катышуучуларына арналган — аларга жетүүнү вендор жеке-жеке берет. Бардык каналдардын артефактары ар бир архитектурага ылайык tarball катары, .sha256 текшерүү суммасы жана cosign .sig колу менен таратылат — экөө тең орнотуу учурунда жана ар бир жаңыртууда текшерилет.

Орнотууну текшерүү

Орноткуч бүткөндөн кийин кызматты жана даярдык эндпойнтун текшериңиз:

systemctl status aihummer-gateway
curl -fsS http://localhost:8780/healthz
curl -fsS http://localhost:8780/readyz

/healthz тирүүлүктү жана версияны билдирет; /readyz PostgreSQL’ди текшерет жана маалымат базасы жеткиликтүү болгонго чейин 503 кайтарат. Комплекттеги aihummer CLI ошондой эле тез ден соолук обзору үчүн aihummer status жана aihummer doctor буйруктарын сунуштайт.

Кийинки кадам

Биринчи иштетүү: ~/.aihummer/etc/initial-admin-password.txt файлындагы баштапкы админ паролун алуу үчүн Биринчи кирүү бөлүмүн караңыз.
Жайылтууну ыңгайлаңыз: Конфигурацияны окуңуз.
Биринчи иштетүүнү кадам-кадам менен басып өткүңүз келеби? Тез баштоону колдонуңуз.