Усталёўка — AiHummer Дакументацыя

AiHummer усталёўваецца host-native. Усталёўка пачынаецца ў асабістым кабінеце my.aihummer.ru: вы рэгіструецеся, атрымліваеце персанальную спасылку ўсталёўкі і запускаеце адну каманду на сваім серверы. Скрыпт усталёўкі спампоўвае падпісаны пакет для адпаведнай архітэктуры, разгортвае адзіны корань усталёўкі ў ~/.aihummer (у хатняй дырэкторыі карыстальніка, які запусціў усталёўшчык), рэгіструе юніты systemd і пры неабходнасці разгортвае сайдкары. У гэтым працэсе нідзе няма кантэйнераў.

[!NOTE] Гэта host-native усталёўка — рэлізны tarball, што працуе пад systemd, а не Docker. Gateway, сайдкары і плагіны кожны працуюць як свой уласны сэрвіс 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, праверыць абодва, распакуе корань усталёўкі і зарэгіструе сэрвіс gateway. Бягучы рэліз — у Спісе змен.

[!WARNING] Персанальная спасылка — гэта ваш ключ да дыстрыбутыва. Не публікуйце яе: кожны, у каго ёсць спасылка, можа спампоўваць зборкі ад вашага імя, пакуль не скончыцца тэрмін дзеяння токена.

Раскладка кораня ўсталёўкі

Усё знаходзіцца ў адной дырэкторыі, ~/.aihummer — у хатняй дырэкторыі карыстальніка, які запусціў усталёўшчык (пад sudo гэта карыстальнік, які выклікаў sudo, а не root: напрыклад, /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-рэжым: юніты рэгіструюцца ў карыстальніцкім scope systemd --user (файлы ў ~/.config/systemd/user), CLI aihummer і cosign кладуцца ў ~/.aihummer/bin, а калі не зададзены AIHUMMER_DATABASE_URL, усталёўшчык разгортвае карыстальніцкі (user-mode) кластар PostgreSQL унутры кораня ўсталёўкі. Сэрвісамі кіруюць камандамі systemctl --user .... Каб сэрвісы стартавалі пры загрузцы хаста (а не толькі пры ўваходзе карыстальніка), уключыце lingering:

loginctl enable-linger $USER

Выбар сайдкараў

Лёгкія медыя-сайдкары — STT (faster-whisper), TTS (edge-tts) і video — ставяцца з каробкі, без пытанняў і сцягоў: голас «туды-назад» працуе адразу. Адключыць любы з іх можна зменнымі асяроддзя AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1.

Пра астатнія сайдкары ўсталёўшчык пытаецца інтэрактыўна (на tty), або імі кіруюць сцягі — гэта поўны спіс:

Сцяг	Эфект
`--with-search` / `--with-browser`	Усталяваць SearXNG / headless Chrome натыўна, без пытання
`--external-search=URL` / `--external-browser=URL`	Выкарыстоўваць існуючы сэрвіс па гэтым URL замест усталёўкі
`--no-search` / `--no-browser`	Прапусціць гэты сайдкар
`--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 the embedder, without the browser
curl -fsSL "<персанальная спасылка ўсталёўкі>" | sudo bash -s -- \
  --with-search --with-embedder --no-browser

Паколькі да сайдкараў звяртаюцца па URL, можна свабодна змешваць натыўныя і знешнія і накіроўваць некалькі gateway’аў на адзін агульны сайдкар.

Каналы рэлізу

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, пакуль база даных недаступная. Убудаваны CLI aihummer таксама прадастаўляе aihummer status і aihummer doctor для хуткага агляду стану.

Куды далей

Першы запуск: глядзіце Першы ўваход, каб атрымаць стартавы адмінскі пароль з файла ~/.aihummer/etc/initial-admin-password.txt.
Наладзьце разгортванне: чытайце Канфігурацыю.
Хочаце прайсці першы запуск крок за крокам? Скарыстайцеся Хуткім стартам.