Насб — AiHummer Ҳуҷҷатнигорӣ

AiHummer host-native насб мешавад. Насб дар кабинети шахсии my.aihummer.ru оғоз меёбад: шумо сабти ном мекунед, пайванди шахсии насб мегиред ва як фармонро дар сервери худ иҷро мекунед. Скрипти насб бандли имзошудаи ба меъмории лозим мувофиқро зеркашӣ мекунад, решаи ягонаи насбро дар ~/.aihummer (дар директорияи хонагии корбаре, ки насбкунандаро иҷро кардааст) мерезонад, воҳидҳои systemd-ро сабт мекунад ва дар сурати зарурат sidecar-ҳоро таъмин мекунад. Дар ин ҷараён дар ҳеҷ куҷо контейнерҳо нестанд.

[!NOTE] Ин насби host-native аст — як tarball-и релиз, ки дар зери systemd кор мекунад, на Docker. Gateway, 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 рӯз эътибор дорад — пас аз гузаштани мӯҳлат танҳо дар ҳамон экран пайванди нав гиред. Нусхаи (instance) аллакай насбшуда пас аз гузаштани мӯҳлат ҳам тавассути пайванди худ навсозӣ шуданро идома медиҳад.

Скрипт меъмории CPU-и шуморо муайян мекунад, бандли мувофиқро якҷоя бо checksum-и .sha256 ва имзои cosign-и .sig-и он зеркашӣ мекунад, ҳардуро тасдиқ мекунад, решаи насбро кушода мегирад ва хидмати gateway-ро сабт мекунад. Релизи ҷорӣ — дар феҳристи тағйирот.

[!WARNING] Пайванди шахсӣ калиди шумо ба дистрибутив аст. Онро нашр накунед: ҳар касе, ки пайванд дорад, метавонад то гузаштани мӯҳлати токен аз номи шумо build-ҳоро зеркашӣ кунад.

Тарҳбандии решаи насб

Ҳама чиз дар зери як директория, ~/.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/ symlink карда мешаванд, бинобар ин онҳо бо фармонҳои оддии 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

Интихоби 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 the embedder, without the browser
curl -fsSL "<пайванди шахсии насб>" | sudo bash -s -- \
  --with-search --with-embedder --no-browser

Азбаски ба sidecar-ҳо бо URL дастрасӣ ҳосил мешавад, шумо метавонед нативӣ ва берунаро озодона омехта кунед ва якчанд gateway-ро ба як sidecar-и муштарак равона кунед.

Каналҳои релиз

AiHummer дар чор канал интиқол меёбад: stable, alfa, beta ва dev. Пайванди шахсӣ аз кабинети шахсӣ канали stable-ро насб мекунад — ин роҳи муқаррарӣ барои ҳамаи корбарон аст.

Канал	Дастрасӣ	Печонидашуда (Obfuscated)
stable	Пайванди шахсӣ аз кабинети шахсӣ	—
alfa	Аз ҷониби вендор дода мешавад (барномаҳои санҷиш)	Бале
beta	Аз ҷониби вендор дода мешавад (барномаҳои санҷиш)	Бале
dev	Аз ҷониби вендор дода мешавад	Не (печонданашуда)

Каналҳои alfa/beta/dev бо калид маҳдуданд ва барои иштирокчиёни барномаҳои санҷиши барвақт пешбинӣ шудаанд — дастрасиро ба онҳо вендор ба таври инфиродӣ медиҳад. Артефактҳои ҳамаи каналҳо ҳамчун tarball-и ба ҳар меъморӣ якҷоя бо checksum-и .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 гиред.
Ҷойгиркуниро танзим кунед: Танзимот-ро хонед.
Мехоҳед иҷрои аввалро қадам ба қадам тай кунед? Оғози зуд-ро истифода баред.