Аинсталл — AiHummer Адокументациа

AiHummer идыргылоит хост-нативтә. Аинсталл иалагоит ахаҭалатә кабинет my.aihummer.ru аҟны: шәара иашәырегистрируеит, ишәоуеит хаҭалатә инсталл линк насгьы иаишьҭтә ак команда шәара шәсервер аҿы. Аинсталл скрипт инанагоит иархиоу, архитектура-аканы бандл, иаргылоит ак инсталл рут ~/.aihummer аҟны (анинсталлер издәықылаз ахархәаҩ иҩнытәи адиректориа аҿы), иаргистрироит systemd аиԥшрақәа, насгьы иалкаау иаргылоит сайдкарқәа. Абри апроцесс аҿы аконтейнерқәа акгьа ыҟам.

[!NOTE] Ари хост-нативтә инсталлуп — арелизтә тарбол systemd иаҵаҟа иныҟәо, акымкуа Docker. Гейтуэй, сайдкарқәа насгьы аплагинқәа дара хазы рхатәы 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 аҵаҟа ари 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 — иргылоит ианга-иангақәа, азҵаарақәеи флагқәеи рыда: абжьы «уаҟа-уаҩыҟа» аусуеит иаразнак. Дарбанзаалакь иаҿыхразы иашәхархәа environment аҽеиҭакрақәа 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-ԥшаара ала. UI абызшәа иаргылоит 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

Избандуа сайдкарқәа иаауеит URL ала, ишәылшоит иашәеилардаратә нативтә насгьы внешнетә хәдамкуа, насгьы иашәпинтә гейтуэй рацәак ак иадгылоу сайдкар ахь.

Арелизтә каналқәа

AiHummer иныҟәоит ҧшьба каналқәа рыла: stable, alfa, beta насгьы dev. Ахаҭалатә кабинет аҟынтәи хаҭалатә линк иаргылоит stable канал — ари ахархәаҩ зегьы рзы иҵыхәтәоу амҩоуп.

Канал	Ахьынӡара	Иобфускироу
stable	Ахаҭалатә кабинет аҟынтәи хаҭалатә линк	—
alfa	Авендор инаҭоит (атесттә программақәа)	Ааи
beta	Авендор инаҭоит (атесттә программақәа)	Ааи
dev	Авендор инаҭоит	Мап (иобфускироуам)

Alfa/beta/dev каналқәа аклавиш-аканы ауп насгьы дара иазырхиоуп заатәи атесттә программақәа рлахәылацәа рзы — урҭ рахь ахьынӡара авендор инаҭоит хазхазы. Канал зегьы рартефактқәа иныҟәоит архитектура-аканы тарбол аиԥш уи .sha256 чексумма насгьы cosign .sig подпис иадгылоу — ҩыџьагьы иҵабыргуп анинсталлраан насгьы аҿыцразаалакь аан.

Аинсталл аҵабыргра

Анинсталлер аналгакь, иашәырба аусура насгьы аиқәырхаратә эндпоинт:

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

/healthz иаанарԥшуеит ахаԥсра насгьы аверсиа; /readyz иҵабыргуеит PostgreSQL насгьы иаргьежьуеит 503 adatabaza ахьаауаргьаанӡа. Иаргьежьтә иадгылоу aihummer CLI еицгьы иаанарԥшуеит aihummer status насгьы aihummer doctor иласу ахаԥсратә овервью азы.

Иахьынтә ашьҭахь

Актәи аус: иашәырба Актәи алогин акаамҭатәи аадминистраторатә пароль аиура азы афайл ~/.aihummer/etc/initial-admin-password.txt аҟынтә.
Иашәырҿиа адислои: иашәырԥхьа Аиҿартәара.
Иашәҭаху иашәырцәажәа актәи аус арбагала арбагала? Иашәхархәа Квикстарт.