Oʻrnatish — AiHummer Hujjatlar

AiHummer host-native oʻrnatiladi. Oʻrnatish my.aihummer.ru shaxsiy kabinetida boshlanadi: siz roʻyxatdan oʻtasiz, shaxsiy oʻrnatish havolasini olasiz va oʻz serveringizda bitta buyruqni ishga tushirasiz. Oʻrnatish skripti kerakli arxitektura uchun imzolangan bundle’ni yuklab oladi, ~/.aihummer ostida (oʻrnatuvchini ishga tushirgan foydalanuvchining uy katalogida) yagona oʻrnatish ildizini joylashtiradi, systemd birliklarini roʻyxatga oladi va zarur boʻlsa sidecar’larni oʻrnatadi. Ushbu jarayonda hech qayerda konteynerlar yoʻq.

[!NOTE] Bu host-native oʻrnatish — systemd ostida ishlaydigan release tarball, Docker emas. Gateway, sidecar’lar va pluginlarning har biri oʻz systemd xizmati sifatida ishlaydi.

1-qadam: shaxsiy oʻrnatish havolasini oling

Ommaviy oʻrnatish skripti endi yoʻq — oʻrnatish havolasi shaxsiy boʻlib, shaxsiy kabinetda beriladi:

my.aihummer.ru da roʻyxatdan oʻting (email + parol, xatdan kelgan 6 xonali kod bilan tasdiqlash).
«Oʻrnatish» ekranini oching va «Shaxsiy oʻrnatish havolasini olish» tugmasini bosing.
Kabinet shaxsiy havolangiz bilan tayyor buyruqni koʻrsatadi.

Kabinetning oʻzi haqida batafsil (rekvizitlar, hujjatlar, tariflar) — Shaxsiy kabinet sahifasida.

2-qadam: bitta buyruq bilan oʻrnatish

«Oʻrnatish» ekranidagi buyruqni nusxalab, serverda (Linux x86_64/arm64) ishga tushiring:

curl -fsSL "<shaxsiy oʻrnatish havolasi>" | sudo bash

Shaxsiy havola https://my.aihummer.ru/dl/<token>/install.sh koʻrinishida boʻladi, hisobingizga bogʻlangan va 30 kun amal qiladi — muddati tugagach, xuddi shu ekranda yangisini oling. Allaqachon oʻrnatilgan instans muddat tugaganidan keyin ham oʻz havolasi orqali yangilanishda davom etadi.

Skript CPU arxitekturangizni aniqlaydi, mos bundle’ni uning .sha256 nazorat yigʻindisi va cosign .sig imzosi bilan birga yuklab oladi, ikkalasini tekshiradi, oʻrnatish ildizini ochadi va gateway xizmatini roʻyxatga oladi. Joriy reliz uchun Oʻzgarishlar tarixi ga qarang.

[!WARNING] Shaxsiy havola — bu sizning distributivga kalitingiz. Uni eʼlon qilmang: havolaga ega boʻlgan har kim token muddati tugaguncha sizning nomingizdan build’larni yuklab olishi mumkin.

Oʻrnatish ildizi tuzilishi

Hamma narsa bitta katalog, ~/.aihummer ostida yashaydi — oʻrnatuvchini ishga tushirgan foydalanuvchining uy katalogida (sudo ostida bu root emas, sudo ni chaqirgan foydalanuvchi: masalan, /home/ivan/.aihummer). Fayllar oʻsha foydalanuvchiga tegishli va xizmatlar uning nomidan ishlaydi:

~/.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/ ostida yaratilgan systemd birlik fayllari /etc/systemd/system/ ga symlink qilinadi, shu sababli ular oddiy systemctl buyruqlari bilan boshqariladi.

Root’siz oʻrnatish (rootless)

sudo/root huquqlari majburiy emas. Oʻrnatish buyrugʻini sudo’siz ishga tushirsangiz, oʻrnatuvchi rootless rejimga oʻtadi: birliklar foydalanuvchi scope’idagi systemd --user da roʻyxatga olinadi (fayllar ~/.config/systemd/user da), aihummer CLI va cosign ~/.aihummer/bin ga joylashadi, agar AIHUMMER_DATABASE_URL berilmagan boʻlsa, oʻrnatuvchi oʻrnatish ildizi ichida foydalanuvchi rejimidagi (user-mode) PostgreSQL klasterini yaratadi. Xizmatlar systemctl --user ... buyruqlari bilan boshqariladi. Xizmatlar xost yuklanganda (faqat foydalanuvchi kirganda emas) ishga tushishi uchun lingering’ni yoqing:

loginctl enable-linger $USER

Sidecar’larni tanlash

Yengil media-sidecar’lar — STT (faster-whisper), TTS (edge-tts) va video — quticha tashqarisidayoq oʻrnatiladi, savollarsiz va bayroqlarsiz: ovoz «borish-qaytish» darhol ishlaydi. Ularning istalganini AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1 muhit oʻzgaruvchilari bilan oʻchirish mumkin.

Qolgan sidecar’lar haqida oʻrnatuvchi interaktiv soʻraydi (tty’da), yoki ular bayroqlar bilan boshqariladi — toʻliq roʻyxat:

Bayroq	Taʼsir
`--with-search` / `--with-browser`	SearXNG / headless Chrome’ni savolsiz natively oʻrnatish
`--external-search=URL` / `--external-browser=URL`	Oʻrnatish oʻrniga ushbu URL’dagi mavjud xizmatdan foydalanish
`--no-search` / `--no-browser`	Bu sidecar’ni oʻtkazib yuborish
`--with-embedder`	Semantik embedder’ni oʻrnatish (opt-in: PyTorch’ni tortadi — yuzlab MB)

tty boʻlmasa va bayroq berilmasa, search/browser oʻtkazib yuboriladi. Embedder AIHUMMER_WITH_EMBEDDER=1 oʻzgaruvchisi bilan ham yoqiladi; usiz xotira leksik fallback-qidiruvda ishlaydi. Interfeys tilini AIHUMMER_LANG=ru|en belgilaydi (aks holda oʻrnatuvchi tty’da soʻraydi). PostgreSQL ulanishi tty’da soʻraladi; interaktiv boʻlmagan oʻrnatish uchun AIHUMMER_DATABASE_URL ni oldindan oʻrnating. tty’da oʻrnatuvchi zaxira nusxadan tiklashni ham taklif qiladi.

# Install the gateway with native search and embedder, no browser
curl -fsSL "<shaxsiy oʻrnatish havolasi>" | sudo bash -s -- \
  --with-search --with-embedder --no-browser

Sidecar’larga URL orqali murojaat qilingani uchun, native va tashqi variantlarni erkin aralashtirishingiz va bir nechta gateway-ni bitta umumiy sidecar-ga yoʻnaltirishingiz mumkin.

Reliz kanallari

AiHummer toʻrtta kanalda yetkaziladi: stable, alfa, beta va dev. Shaxsiy kabinetdagi shaxsiy havola stable kanalini oʻrnatadi — bu barcha foydalanuvchilar uchun odatiy yoʻl.

Kanal	Kirish	Obfuskatsiya qilingan
stable	Shaxsiy kabinetdagi shaxsiy havola	—
alfa	Vendor tomonidan beriladi (test dasturlari)	Ha
beta	Vendor tomonidan beriladi (test dasturlari)	Ha
dev	Vendor tomonidan beriladi	Yoʻq (obfuskatsiyasiz)

alfa/beta/dev kanallari kalit bilan himoyalangan va erta test dasturlari ishtirokchilari uchun moʻljallangan — ularga kirishni vendor individual tarzda beradi. Barcha kanallarning artefaktlari har bir arxitektura uchun tarball koʻrinishida, .sha256 nazorat yigʻindisi va cosign .sig imzosi bilan birga tarqatiladi — ikkalasi oʻrnatishda va har bir yangilanishda tekshiriladi.

Oʻrnatishni tekshirish

Oʻrnatuvchi tugagandan soʻng, xizmat va tayyorlik nuqtasini tekshiring:

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

/healthz tiriklik va versiyani xabar qiladi; /readyz PostgreSQL’ni tekshiradi va maʼlumotlar bazasi yetib boriladigan boʻlguncha 503 qaytaradi. Birlashtirilgan aihummer CLI shuningdek tezkor salomatlik koʻrinishi uchun aihummer status va aihummer doctor ni taqdim etadi.

Keyingi qadam qayerda

Birinchi ishga tushirish: ~/.aihummer/etc/initial-admin-password.txt faylidan boshlangʻich admin parolini olish uchun Birinchi kirish ga qarang.
Joylashtirishni sozlash: Konfiguratsiya ni oʻqing.
Birinchi ishga tushirishni bosqichma-bosqich koʻrib chiqmoqchimisiz? Tezkor boshlash dan foydalaning.