Орнату — 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/-ге символдық сілтемемен жалғанады, сондықтан олар кәдімгі 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 файлындағы бастапқы әкімші паролін алу үшін Алғашқы кіру бөлімін қараңыз.
Орналастыруды баптаңыз: Конфигурацияны оқыңыз.
Алғашқы іске қосуды қадам-қадаммен өткіңіз келе ме? Жылдам бастауды қолданыңыз.