Quraşdırma — AiHummer Sənədlər

AiHummer host-native quraşdırılır. Quraşdırma my.aihummer.ru şəxsi kabinetində başlayır: qeydiyyatdan keçirsiniz, şəxsi quraşdırma keçidi alırsınız və öz serverinizdə tək bir əmr işə salırsınız. Quraşdırma skripti lazımi arxitektura üçün imzalanmış paketi yükləyir, tək quraşdırma kökünü ~/.aihummer altında düzür (installer-i işə salan istifadəçinin ev qovluğunda), systemd unit-lərini qeydiyyatdan keçirir və lazım olduqda sidecar-ları təmin edir. Bu prosesin heç bir yerində konteynerlər yoxdur.

[!NOTE] Bu, host-native quraşdırmadır — systemd altında işləyən buraxılış tarball-ı, Docker deyil. Gateway, sidecar-lar və plaginlər hər biri öz systemd servisi kimi işləyir.

Addım 1: şəxsi quraşdırma keçidini alın

İctimai quraşdırma skripti artıq yoxdur — quraşdırma keçidi şəxsidir və şəxsi kabinetdə verilir:

my.aihummer.ru-da qeydiyyatdan keçin (email + parol, məktubdan gələn 6 rəqəmli kodla təsdiq).
«Quraşdırma» ekranını açın və «Şəxsi quraşdırma keçidini al» düyməsini basın.
Kabinet şəxsi keçidinizlə hazır əmri göstərəcək.

Kabinetin özü haqqında ətraflı (rekvizitlər, sənədlər, tariflər) — Şəxsi kabinet səhifəsində.

Addım 2: bir əmrlə quraşdırma

Əmri «Quraşdırma» ekranından kopyalayın və serverdə işə salın (Linux x86_64/arm64):

curl -fsSL "<şəxsi quraşdırma keçidi>" | sudo bash

Şəxsi keçid https://my.aihummer.ru/dl/<token>/install.sh formasındadır, hesabınıza bağlıdır və 30 gün qüvvədədir — müddət bitdikdə sadəcə eyni ekranda yenisini alın. Artıq quraşdırılmış nümunə (instance) müddət bitdikdən sonra da öz keçidi vasitəsilə yenilənməyə davam edir.

Skript CPU arxitekturasını aşkar edir, uyğun paketi onun .sha256 yoxlama məbləği və cosign .sig imzası ilə birlikdə yükləyir, hər ikisini yoxlayır, quraşdırma kökünü açır və gateway servisini qeydiyyatdan keçirir. Cari buraxılış üçün dəyişikliklər jurnalına baxın.

[!WARNING] Şəxsi keçid distributivə açarınızdır. Onu dərc etməyin: keçidə malik hər kəs token-in müddəti bitənə qədər sizin adınızdan build-ləri yükləyə bilər.

Quraşdırma kökünün düzülüşü

Hər şey bir kataloq altında, ~/.aihummer-də yerləşir — installer-i işə salan istifadəçinin ev qovluğunda (sudo altında bu, root deyil, sudo-nu çağıran istifadəçidir: məsələn /home/ivan/.aihummer). Fayllar həmin istifadəçiyə məxsusdur və servislər onun adından işləyir:

~/.aihummer/
├── bin/        gateway binary və aihummer CLI
├── etc/        konfiqurasiya (gateway.env)
├── share/      statik aktivlər (admin UI, vidcet)
├── sidecars/   istəyə bağlı STT/TTS/və s. servislər
├── plugins/    quraşdırılmış marketplace plaginləri
├── systemd/    unit faylları (/etc/systemd/system-ə simvolik bağlanır)
├── state/      iş zamanı vəziyyəti
├── data/       blob/media saxlama
└── logs/       servis logları

systemd/ altında yaradılan systemd unit faylları /etc/systemd/system/-ə simvolik bağlanır, beləliklə onlar adi systemctl əmrləri ilə idarə olunur.

Root olmadan quraşdırma (rootless)

sudo/root hüquqları məcburi deyil. Quraşdırma əmrini sudo olmadan işə salsanız, installer rootless rejimə keçir: unit-lər istifadəçi scope-unda systemd --user qeydiyyatdan keçirilir (fayllar ~/.config/systemd/user-də), aihummer CLI və cosign ~/.aihummer/bin-ə qoyulur, AIHUMMER_DATABASE_URL təyin edilməyibsə isə installer quraşdırma kökünün içində istifadəçi rejimli (user-mode) PostgreSQL klasteri açır. Servislər systemctl --user ... əmrləri ilə idarə olunur. Servislərin hostun yüklənməsi ilə (yalnız istifadəçi daxil olduqda deyil) başlaması üçün lingering-i aktivləşdirin:

loginctl enable-linger $USER

Sidecar-ların seçilməsi

Yüngül media sidecar-ları — STT (faster-whisper), TTS (edge-tts) və video — qutudan çıxan kimi quraşdırılır, sual və bayraq olmadan: səs «gediş-gəliş» dərhal işləyir. Onların hər hansı birini AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1 mühit dəyişənləri ilə söndürmək olar.

Qalan sidecar-lar barədə installer interaktiv soruşur (tty-də), ya da onlar bayraqlarla idarə olunur — tam siyahı budur:

Bayraq	Effekt
`--with-search` / `--with-browser`	SearXNG-i / headless Chrome-u sualsız nativ quraşdır
`--external-search=URL` / `--external-browser=URL`	Quraşdırmaq yerinə bu URL-dəki mövcud servisi istifadə et
`--no-search` / `--no-browser`	Bu sidecar-ı keç
`--with-embedder`	Semantik embedder quraşdır (opt-in: PyTorch çəkir — yüzlərlə MB)

Tty və search/browser bayrağı olmadıqda onlar keçilir. Embedder həmçinin AIHUMMER_WITH_EMBEDDER=1 dəyişəni ilə aktivləşdirilir; onsuz yaddaş leksik fallback axtarışında işləyir. İnterfeys dilini AIHUMMER_LANG=ru|en təyin edir (əks halda installer tty-də soruşacaq). PostgreSQL bağlantısı tty-də soruşulur; qeyri-interaktiv quraşdırma üçün AIHUMMER_DATABASE_URL-u əvvəlcədən təyin edin. Tty-də installer həmçinin ehtiyat nüsxədən bərpanı təklif edir.

# Gateway-i nativ axtarış və embedder ilə, brauzersiz quraşdır
curl -fsSL "<şəxsi quraşdırma keçidi>" | sudo bash -s -- \
  --with-search --with-embedder --no-browser

Sidecar-lara URL ilə çatıldığından, nativ və xarici olanları sərbəst qarışdıra və bir neçə gateway-i bir paylaşılan sidecar-a yönəldə bilərsiniz.

Buraxılış kanalları

AiHummer dörd kanalda göndərilir: stable, alfa, beta və dev. Şəxsi kabinetdən alınan şəxsi keçid stable kanalını quraşdırır — bu, bütün istifadəçilər üçün standart yoldur.

Kanal	Giriş	Obfuskasiya edilib
stable	Şəxsi kabinetdən şəxsi keçid	—
alfa	Vendor tərəfindən verilir (test proqramları)	Bəli
beta	Vendor tərəfindən verilir (test proqramları)	Bəli
dev	Vendor tərəfindən verilir	Xeyr (obfuskasiyasız)

alfa/beta/dev kanalları açar-qapılıdır və erkən test proqramlarının iştirakçıları üçün nəzərdə tutulub — onlara girişi vendor fərdi qaydada verir. Bütün kanalların artefaktları hər arxitektura üçün tarball şəklində, .sha256 yoxlama məbləği və cosign .sig imzası ilə birlikdə yayılır — hər ikisi quraşdırma zamanı və hər yeniləmədə yoxlanılır.

Quraşdırmanın yoxlanması

Installer bitdikdən sonra servisi və hazırlıq endpoint-ini yoxlayın:

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

/healthz canlılıq və versiya barədə məlumat verir; /readyz PostgreSQL-i yoxlayır və verilənlər bazası əlçatan olana qədər 503 qaytarır. Komplektə daxil olan aihummer CLI həmçinin sürətli sağlamlıq icmalı üçün aihummer status və aihummer doctor təqdim edir.

Növbəti hara

İlk işə salma: başlanğıc admin parolunu ~/.aihummer/etc/initial-admin-password.txt faylından əldə etmək üçün İlk giriş səhifəsinə baxın.
Deploy-u tənzimləyin: Konfiqurasiya oxuyun.
İlk işə salmanı addım-addım keçmək istəyirsiniz? Sürətli başlanğıc-dan istifadə edin.