Instalare — AiHummer Documentație

AiHummer se instalează nativ pe gazdă. Instalarea începe în contul personal my.aihummer.ru: te înregistrezi, primești un link personal de instalare și rulezi o singură comandă pe serverul tău. Scriptul de instalare descarcă bundle-ul semnat pentru arhitectura potrivită, dispune o singură rădăcină de instalare în ~/.aihummer (în directorul home al utilizatorului care a lansat installer-ul), înregistrează unități systemd și, la nevoie, provizionează sidecars. Nu există niciun container nicăieri în acest proces.

[!NOTE] Aceasta este o instalare nativă pe gazdă — un release tarball care rulează sub systemd, nu Docker. Gateway-ul, sidecars-urile și pluginurile rulează fiecare ca propriul serviciu systemd.

Pasul 1: obține linkul personal de instalare

Nu mai există un script public de instalare — linkul de instalare este personal și se emite în contul personal:

Înregistrează-te pe my.aihummer.ru (email + parolă, confirmare cu un cod de 6 cifre primit prin email).
Deschide ecranul „Instalare” și apasă „Obține linkul personal de instalare”.
Contul îți va afișa comanda gata pregătită cu linkul tău personal.

Mai multe despre contul propriu-zis (date de facturare, documente, planuri) — pe pagina Cont personal.

Pasul 2: instalare cu o singură comandă

Copiază comanda de pe ecranul „Instalare” și rulează-o pe server (Linux x86_64/arm64):

curl -fsSL "<link personal de instalare>" | sudo bash

Linkul personal are forma https://my.aihummer.ru/dl/<token>/install.sh, este legat de contul tău și este valabil 30 de zile — după expirare, pur și simplu obții unul nou pe același ecran. O instanță deja instalată continuă să se actualizeze prin linkul ei și după expirarea termenului.

Scriptul detectează arhitectura CPU, descarcă bundle-ul potrivit împreună cu checksum-ul său .sha256 și semnătura cosign .sig, le verifică pe ambele, despachetează rădăcina de instalare și înregistrează serviciul gateway. Release-ul curent este în Changelog.

[!WARNING] Linkul personal este cheia ta către distribuție. Nu îl publica: oricine are linkul poate descărca build-uri în numele tău până când expiră tokenul.

Aspectul rădăcinii de instalare

Totul trăiește sub un singur director, ~/.aihummer — în directorul home al utilizatorului care a lansat installer-ul (sub sudo acesta este utilizatorul care a invocat sudo, nu root: de exemplu, /home/ivan/.aihummer). Fișierele aparțin acestui utilizator, iar serviciile rulează în numele lui:

~/.aihummer/
├── bin/        binarul gateway și CLI-ul aihummer
├── etc/        configurație (gateway.env)
├── share/      assets statice (admin UI, widget)
├── sidecars/   servicii opționale STT/TTS/etc.
├── plugins/    pluginuri instalate din marketplace
├── systemd/    fișiere de unitate (legate simbolic în /etc/systemd/system)
├── state/      stare de runtime
├── data/       stocare blob/media
└── logs/       loguri de servicii

Fișierele de unitate systemd generate sub systemd/ sunt legate simbolic în /etc/systemd/system/, astfel încât sunt gestionate cu comenzi systemctl obișnuite.

Instalare fără root (rootless)

Drepturile sudo/root nu sunt obligatorii. Dacă rulezi comanda de instalare fără sudo, installer-ul trece în modul rootless: unitățile se înregistrează în scope-ul de utilizator systemd --user (fișiere în ~/.config/systemd/user), CLI-ul aihummer și cosign ajung în ~/.aihummer/bin, iar dacă AIHUMMER_DATABASE_URL nu este setat, installer-ul provizionează un cluster PostgreSQL în mod utilizator (user-mode) în interiorul rădăcinii de instalare. Serviciile se gestionează cu comenzi systemctl --user .... Pentru ca serviciile să pornească la bootarea gazdei (nu doar la login-ul utilizatorului), activează lingering:

loginctl enable-linger $USER

Alegerea sidecars-urilor

Sidecars-urile media ușoare — STT (faster-whisper), TTS (edge-tts) și video — se instalează din start, fără întrebări și fără flag-uri: vocea „dus-întors” funcționează imediat. Oricare dintre ele poate fi dezactivat prin variabilele de mediu AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1.

Despre restul sidecars-urilor installer-ul întreabă interactiv (pe tty), sau sunt conduse prin flag-uri — aceasta este lista completă:

Flag	Efect
`--with-search` / `--with-browser`	Instalează SearXNG / headless Chrome nativ, fără întrebare
`--external-search=URL` / `--external-browser=URL`	Folosește un serviciu existent la acest URL în loc să instalezi unul
`--no-search` / `--no-browser`	Sari peste acest sidecar
`--with-embedder`	Instalează embedder-ul semantic (opt-in: trage PyTorch — sute de MB)

Fără tty și fără flag, search/browser sunt sărite. Embedder-ul se activează și prin variabila AIHUMMER_WITH_EMBEDDER=1; fără el memoria funcționează pe căutare lexicală de fallback. Limba interfeței este setată de AIHUMMER_LANG=ru|en (altfel installer-ul întreabă pe tty). Conexiunea la PostgreSQL este cerută pe tty; pentru o instalare neinteractivă setează din timp AIHUMMER_DATABASE_URL. Pe tty installer-ul propune și restaurarea dintr-un backup.

# Instalează gateway-ul cu căutare nativă și embedder, fără browser
curl -fsSL "<link personal de instalare>" | sudo bash -s -- \
  --with-search --with-embedder --no-browser

Deoarece sidecars-urile sunt accesate prin URL, poți amesteca liber nativ și extern și poți îndrepta mai multe gateway-uri către un singur sidecar partajat.

Canale de release

AiHummer se livrează pe patru canale: stable, alfa, beta și dev. Linkul personal din contul personal instalează canalul stable — aceasta este calea standard pentru toți utilizatorii.

Canal	Acces	Obfuscat
stable	Link personal din contul personal	—
alfa	Emis de vendor (programe de testare)	Da
beta	Emis de vendor (programe de testare)	Da
dev	Emis de vendor	Nu (neobfuscat)

Canalele alfa/beta/dev sunt protejate prin cheie și sunt destinate participanților la programele de testare timpurie — accesul la ele este acordat individual de vendor. Artefactele tuturor canalelor se distribuie ca tarball per arhitectură împreună cu checksum-ul .sha256 și semnătura cosign .sig — ambele sunt verificate la instalare și la fiecare actualizare.

Verificarea instalării

După ce installer-ul se termină, verifică serviciul și endpoint-ul de pregătire:

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

/healthz raportează liveness-ul și versiunea; /readyz verifică PostgreSQL și returnează 503 până când baza de date este accesibilă. CLI-ul aihummer împachetat expune de asemenea aihummer status și aihummer doctor pentru o privire rapidă de ansamblu asupra sănătății.

Unde mergi mai departe

Prima rulare: vezi Primul login pentru a recupera parola de start a administratorului din fișierul ~/.aihummer/etc/initial-admin-password.txt.
Reglează deployment-ul: citește Configurare.
Vrei să parcurgi prima rulare pas cu pas? Folosește Quickstart.