Установка — 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. Актуальный релиз — в журнале изменений.

Персональная ссылка также привязывает инстанс к вашему личному кабинету: установщик сохраняет токен из ссылки, инстанс передаёт его при первой регистрации у вендора, и кабинет автоматически связывает инстанс с вашей учётной записью, а ваш e-mail сразу становится подтверждённым контактом инстанса — привязывать и подтверждать почту в Web UI отдельно не нужно, и лицензия доставляется без ручных шагов.

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

Раскладка корня установки

Всё лежит под одной директорией, ~/.aihummer — в домашней директории пользователя, запустившего установщик (под sudo это пользователь, вызвавший sudo, а не root: например, /home/ivan/.aihummer). Файлы принадлежат этому пользователю, и сервисы работают от его имени:

~/.aihummer/
├── bin/        бинарь gateway и CLI aihummer
├── etc/        конфигурация (gateway.env)
├── share/      статические ассеты (админка, виджет)
├── sidecars/   опциональные сервисы STT/TTS/и т.д.
├── plugins/    установленные плагины маркетплейса
├── systemd/    юнит-файлы (симлинки в /etc/systemd/system)
├── state/      рантайм-состояние
├── data/       хранилище блобов/медиа
└── 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 установщик также предлагает восстановление из резервной копии.

# Установить gateway с нативным поиском и эмбеддером, без браузера
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.
Настройка развёртывания: читайте Конфигурацию.
Хотите пройти первый запуск по шагам? Используйте Квикстарт.