Gurnama — AiHummer Resminamalar

AiHummer host-natiwe gurnalýar. Gurnama siziň şahsy kabinetiňizden my.aihummer.ru başlanýar: hasaba alynýarsyňyz, şahsy gurnama baglanyşygyny alýarsyňyz we serweriňizde ýeke buýruk işledýärsiňiz. Gurnama skripti arhitekturaňyza gabat gelýän gol çekilen bandly ýükleýär, ýeke gurnama kökini ~/.aihummer astynda (gurnaýjyny işleden ulanyjynyň öý katalogynda) ýaýbaňlaýar, systemd birliklerini hasaba alýar we isleg boýunça sidecar-lary üpjün edýär. Bu prosesde hiç ýerde konteýner ýok.

[!NOTE] Bu host-natiwe gurnama — systemd astynda işleýän reliz tarball-y, Docker däl. Gateway, sidecar-lar we pluginler her biri öz systemd hyzmaty hökmünde işleýär.

1-ädim: şahsy gurnama baglanyşygyňyzy alyň

Jemgyýetçilik gurnama skripti mundan beýläk ýok — gurnama baglanyşygy şahsy bolup, şahsy kabinetde berilýär:

my.aihummer.ru saýtynda hasaba alnyň (email + parol, poçta gelen 6 sanly kod bilen tassyklama).
«Gurnama» ekranyny açyň we «Şahsy gurnama baglanyşygyny almak» düwmesine basyň.
Kabinet şahsy baglanyşygyňyz goýlan taýýar buýrugy görkezer.

Kabinetiň özi barada has köp maglumat (rekwizitler, resminamalar, tarifler) — Şahsy kabinet sahypasynda.

2-ädim: bir buýruk bilen gurnama

«Gurnama» ekranyndaky buýrugy göçüriň we ony serweriňizde (Linux x86_64/arm64) işlediň:

curl -fsSL "<şahsy gurnama baglanyşygyňyz>" | sudo bash

Şahsy baglanyşyk https://my.aihummer.ru/dl/<token>/install.sh görnüşinde bolýar, hasabyňyza baglanan we 30 gün güýjünde galýar — möhleti gutaranda, şol ekranda ýönekeýje täzesini alyň (eýýäm gurnalan nusga möhleti gutaranyndan soň hem öz baglanyşygy arkaly täzelenip durýar).

Skript CPU arhitekturaňyzy ýüze çykarýar, gabat gelýän bandly onuň .sha256 barlag jemi we cosign .sig goly bilen ýükleýär, ikisini-de barlaýar, gurnama köküni açýar we gateway hyzmatyny hasaba alýar. Häzirki reliz üçin Üýtgeşmeler taryhyna serediň.

[!WARNING] Şahsy baglanyşygyňyz — paýlanyşa açaryňyzdyr. Ony ýaýratmaň: baglanyşygy bar islendik adam token möhleti gutarýança siziň adyňyzdan gurluşlary ýükläp biler.

Gurnama köküniň ýerleşişi

Ähli zat ýeke katalogyň — ~/.aihummer — astynda ýaşaýar: gurnaýjyny işleden ulanyjynyň öý katalogynda (sudo arkaly bolsa, bu root däl-de, sudo-ny çagyran ulanyjy: mysal üçin, /home/ivan/.aihummer). Faýllar şol ulanyja degişli, hyzmatlar hem şol ulanyjynyň adyndan işleýär:

~/.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/ astynda döredilen systemd birlik faýllary /etc/systemd/system/-e symlink edilýär, şonuň üçin olar adaty systemctl buýruklary bilen dolandyrylýar.

Root-suz gurnama

sudo/root ygtyýarlyklary hökmany däl. Eger gurnama buýrugyny sudo-suz işletseňiz, gurnaýjy root-suz režime geçýär: birlikler ulanyjy systemd --user gerimine hasaba alynýar (faýllar ~/.config/systemd/user içinde), aihummer CLI-si we cosign ~/.aihummer/bin-e düşýär, we eger AIHUMMER_DATABASE_URL bellenmedik bolsa, gurnaýjy gurnama köküniň içinde ulanyjy-rejeli PostgreSQL klasterini üpjün edýär. Hyzmatlar systemctl --user ... buýruklary bilen dolandyrylýar. Hyzmatlaryň host ýüklenende (diňe ulanyjy giren wagty däl-de) başlamagy üçin lingering-i işjeňleşdiriň:

loginctl enable-linger $USER

Sidecar-lary saýlamak

Ýeňil media sidecar-lar — STT (faster-whisper), TTS (edge-tts) we video — gutudan çykan badyna gurnalýar, hiç hili sorag ýa-da baýdaksyz: aýlanyp gelýän ses derrew işleýär. Olaryň islendigini AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1 gurşaw üýtgeýjileri bilen öçürip bolýar.

Galan sidecar-lar barada gurnaýjy interaktiw sorag berýär (tty-de), ýa-da olary baýdaklar dolandyrýar — doly sanaw şu ýerde:

Baýdak	Täsiri
`--with-search` / `--with-browser`	SearXNG / headless Chrome-y soragsyz ýerli guruň
`--external-search=URL` / `--external-browser=URL`	Gurnamagyň ýerine şu URL-däki bar bolan hyzmaty ulanyň
`--no-search` / `--no-browser`	Bu sidecar-y ätläň
`--with-embedder`	Semantik embedderi guruň (isleg boýunça: PyTorch çekýär — ýüzlerçe MB)

tty ýok bolsa we baýdak berilmese, search/browser ätlenýär. Embedder AIHUMMER_WITH_EMBEDDER=1 bilen hem işjeňleşdirilip bilner; onsuz ýat leksiki ätiýaçlyk gözlegde işleýär. Interfeýs dilini AIHUMMER_LANG=ru|en kesgitleýär (bolmasa gurnaýjy tty-de sorar). PostgreSQL birikmesi tty-de soralýar; interaktiw däl gurnamalar üçin AIHUMMER_DATABASE_URL-i öňünden bellemeli. tty-de gurnaýjy şeýle hem ätiýaçlyk nusgadan dikeltmegi hödürleýär.

# Gateway-i ýerli gözleg we embedder bilen, brauzersiz guruň
curl -fsSL "<şahsy gurnama baglanyşygyňyz>" | sudo bash -s -- \
  --with-search --with-embedder --no-browser

Sidecar-lara URL boýunça ýetilýändigi üçin, siz ýerli we daşarkyny erkin garyşdyryp bilersiňiz we birnäçe gateway-i bir paýlaşylan sidecar-a gönükdirip bilersiňiz.

Reliz kanallary

AiHummer dört kanalda iberilýär: stable, alfa, beta we dev. Şahsy kabinetdäki şahsy baglanyşyk stable kanalyny gurnaýar — bu ähli ulanyjylar üçin adaty ýoldyr.

Kanal	Elýeterlilik	Obfuskasiýa edilen
stable	Şahsy kabinetdäki şahsy baglanyşyk	—
alfa	Wendor tarapyndan berilýär (synag programmalary)	Hawa
beta	Wendor tarapyndan berilýär (synag programmalary)	Hawa
dev	Wendor tarapyndan berilýär	Ýok (obfuskasiýa edilmedik)

alfa/beta/dev kanallary açar bilen goralan we irki synag programmalarynyň gatnaşyjylary üçin niýetlenen — olara elýeterliligi wendor aýratynlykda berýär. Ähli kanallardaky artefaktlar arhitektura boýunça tarball hökmünde, .sha256 barlag jemi we cosign .sig goly bilen bile iberilýär — ikisi-de gurnama wagtynda we her täzelenişde barlanýar.

Gurnamany barlamak

Gurnaýjy tamamlanandan soň, hyzmaty we taýýarlyk nokadyny barlaň:

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

/healthz janlylygy we wersiýany habar berýär; /readyz PostgreSQL-i barlaýar we maglumat bazasy elýeterli bolýança 503 gaýtarýar. Birleşdirilen aihummer CLI şeýle hem çalt saglyk gözegçiligi üçin aihummer status we aihummer doctor-y hödürleýär.

Indiki nirä

Ilkinji işleýiş: bir gezeklik admin parolyny ~/.aihummer/etc/initial-admin-password.txt-den almak üçin Ilkinji giriş sahypasyna serediň.
Ýerleşdirmäni sazlaň: Konfigurasiýa okaň.
Ilkinji işleýişi ädimme-ädim geçmek isleýärsiňizmi? Çalt başlangyjy ulanyň.