Gurnama — AiHummer Resminamalar

AiHummer gurýar myhman-oglan. Gurnama şahsy hasabyňyzda başlaýar my.aihummer.ru: hasaba alyn, alyň şahsy gurnama baglanyşygy we serweriňizde bir buýruk işledip bilersiňiz. Gurnama skripti siziň arhitekturanyňyza goly goýlan paketini ýükläp, bir gurnama kökü döredýär ~/.aihummer (gurnalyjy işleten ulanyjynyň öý katalogynda), systemd birliklerini bellige alýar we islege bagly ýagdaýda kömekçi programmalary üpjün edýär. Bu proseste hiç hili konteýner ýok.

[!NOTE] Bu host-öňünden gurnalan programmadyr — systemd aşagynda işleýän bir çykaryş tarbally. däk Docker. Gapgalyjy, gapma-garşy maşynlar we plaginler her biri öz Systemd hökmünde işleýär hizmet.

[!NOTE] Başlamazdan öň nämelere mätäç bolarsyňyz:

a Linux SSH arkaly ýetip boljak server (x86_64 ýa-da arm64);

sudo hukuklary (ýa-da rootless gurmak islegi — aşakda serediň);

PostgreSQL bilen pgcrypto keňişlik — ýa-da gurnamajy üpjün etsin ulanyjy-rejimli toparlaşyk (rootless režiminde munuň özüni özi edýär);

hasapda my.aihummer.ru şahsy almak üçin gurnama baglanyşygy.

Doly talaplar sanawy şul ýerde ýerleşýär Talaplar sahypa.

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

Jemgyýetçilik gurnama skripti ýok — gurnama baglanyşygy şahsy hem-de hasabyňyz portalynda berildi:

Hasaba alyň my.aihummer.ru (telefon belgisi + parol; elektron poçta hem gerek bolar).
Aç Gurnama ekran we “Şahsy gurnama baglanyşygyny almak” düwmesine basyň.
Portal şahsy baglaşygyňyz bilen taýýar amala aşyryljak buýrugy görkezýär.

Portala öňünden (hasap-faktura maglumatlary, resminamalar, meýilnamalar) has giňişleýin maglumat şu ýerde bar Şahsy hasap sahypa.

2-nji ädim: bir buýruga görä gurnama

Buýrugy “Gurnama” ekranyndan göçürip alyň we ony serweriňizde (Linux x86_64/arm64) işlediň:

curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh

Şahsy baglanyşyk https://my.aihummer.ru/dl/<token>/install.sh görnüşinde bolýar we hasabyňyza baglydyr.

[!IMPORTANT] Baglanyşyk bir gezeklik: ol diňe bir gurnama üçin işleýär. Gurnaýjy onuň üsti bilen install.sh faýlyny ýükläninden soň, baglanyşyk sarp edilen hasap edilýär. Şol buýrugy gaýtadan işletseňiz, «baglanyşyk eýýäm ulanyldy» ýalňyşy gaýtarylýar — bu näsazlyk däl, goragdyr. Näme etmeli: şahsy kabinetiňizde «Gurnama» ekranyny açyň we täze baglanyşyk alyň — bu mugt we derrew bolýar.

30 gün möhlet gaýtadan gurnama däl-de, artefaktlary ýüklemäge degişlidir: eýýäm gurnalan nusga baglanyşyk gurnama sarp edilenden soň hem öz baglanyşygy arkaly täzelenip durýar.

Skript CPU arhitekturanyzy öwrenýär, laýyk bukjeti we onuň bilen bilelikde gerekli zatlary ýükläp alýar .sha256 tekshir belgisi we bilelikde gol çekmek .sig golbasy, ikisini hem barlaýar, gurnama kökünü açýar we geçelge hyzmatyny hasaba alýar. Garanyň Üýtgetmeler ýady häzirki çykdajy üçin.

Şahsy baglanyşyk hem mysaly müşderi portal hasabyňyza baglaýar: gurnama bagyňdan tokeni saklaýar, nusga ony satyjy bilen ilkinji hasaba alşykda iberýär we portaly nusgany awtomatiki taýdan hasabyňyz bilen baglaýar. Siziň elektron poçtaňyz derrew nusgaňyz bolýar tassyklanan aragatnaşyk — Web UI-de aýratyn “e-poçta goşmak we tassyklamak” ädimi ýok we ygtyýarname hiç hili el bilen ädim ýoklykda eltilýär.

[!WARNING] Siziň şahsy baglanyşygyňyz paýlamaga açarňyzdyr. Ony çap etmäň: islendik adam baglanyşygy öňünde saklamak token möhleti geçýänçä siziň adyňyzdan gurluşlary ýükläp biler.

Tüwi meşinini gurnamak

Ähli zat bir bukjanyň astynda ýerleşýär. Haýsysynyň astynda — gurnaýjyny nähili işledeniňize bagly:

Nähili gurnaldy	Gurnama köki	Sazlamalar	Hyzmat kimiň adyndan işleýär
Adaty gurnama (`sudo` bilen)	`/home/.aihummer`	`/etc/aihummer/gateway.env`	Aýratyn `aihummer` hyzmat hasaby
Root-suz (rootless)	`~/.aihummer`	`~/.aihummer/etc/gateway.env`	Öz ulanyjyňyz

Adaty gurnama faýllary siziň öý bukjaňyza goýmaýar we hyzmaty siziň adyňyzdan işletmeýär: onuň üçin aýratyn, artykmaç hukugy bolmadyk aihummer ulanyjysy döredilýär. Bu bilkastlaýyn edilen — hyzmatyň ele salynmagy hüjümçä siziň şahsy faýllaryňyzy bermeýär.

Kökiň içindäki gurluş iki režimde-de birmeňzeş (aşakda adaty gurnama görkezilen):

/home/.aihummer/
├── bin/        gateway binary and the aihummer CLI
├── etc/        configuration (gateway.env)
├── share/      static assets for the administration interface
├── 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 birlik faýllary döredilen beýikde systemd/ bar symlink edildi /etc/systemd/system/, şonuň üçin olar kadalylykda dolandyrylýar systemctl buýruklar.

Tamyksyz gurmak

sudo/root hukuklary talap edilmeýär. Gurnama buýrugyny sudo ulanman işletseňiz, gurnaýjy rootless režimine geçýär: birlikler systemd --user çäginde (~/.config/systemd/user faýllarynda) hasaba alynýar, aihummer CLI we cosign ~/.aihummer/bin içine ýerleşdirilýär. AIHUMMER_DATABASE_URL berilmese, gurnaýjy gurnama köküniň içinde ulanyjy režimindäki PostgreSQL klasterini taýýarlaýar. Hyzmatlar systemctl --user ... bilen dolandyrylýar. Hyzmatlar diňe ulanyjy girende däl, host açylanda hem başlasyn diýip lingering-i işjeňleşdiriň:

loginctl enable-linger $USER

Sidekar saýlawy

Agyzlygy ýasalan media gaplary — STT (faster-whisper), TTS (edge-tts) we wideo — gapyň daşyndan gurnama, soraglar ýa-da habar bellikleri bolmazdan: öwrüp-geltirýän ses derrew işleýär. Olaryň haýsydyr birini daş-töwerek üýtgeýänleri bilen öçürip bolýar AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1.

Web gözleg (SearXNG) we brauzer (CloakBrowser) gol çekilen bundle-a girizilendir we standart ýagdaýda oflaýn gurulýar — gurnaýjy indi olar barada soramaýar. Bu häsiýeti flagler bilen üýtgedip bolýar — munuň doly sanawy şulardyr:

baýdak	Täsir
`--no-search` / `--no-browser`	Bu sidan meşinini geç
`--external-search=URL` / `--external-browser=URL`	Gurnamak ýerine bu URL-de bar bolan hyzmatdan peýdalanyň
`--browser-engine=cloak\|chrome`	Brauzer hereketlendirijisi (standart `cloak`)
`--with-search` / `--with-browser`	v1.0.14-den başlap artykmaç: bu eýýäm standart häsiýetdir
`--with-embedder`	Semantik ýerleşdirijiňi gurmak (azat taýdan gatnaşmak: PyTorch-y çekýär — ýüzlerçe MB)

Gözleg we brauzer tty bolmasa-da gurulýar: peýdaly ýük bundle-dan alynýar, munuň üçin internet birikmesi gerek däl. Ikisiniň hem gurnalyşy böwet bolmaýar — peýdaly ýük ýok bolsa ýa-da Python wersiýasy goldanmaýan bolsa, hyzmat diňe sazlanmadyk bolup galýar, gurnama bolsa dowam edýär. Embedder hem şu aşakdakylary bilen işjeňleşdirilip bilner AIHUMMER_WITH_EMBEDDER=1; ol bolmasa ýatlama leksikal alternatif gözlegde işleýär. Ulanyjy interfeýsi dili tarapyndan kesgitlenýär AIHUMMER_LANG=ru|en (başga ýagdaýda gurnama programmasy tty-de sorap biler). PostgreSQL bilen baglanyşyk tty-de soralýar; interaktiw däl gurma üçin goýuň AIHUMMER_DATABASE_URL önünden. TTY-de gurnamaçy hem-de ätiýaçdan halas etmegi teklip edýär.

# Gateway-i embedder bilen, brauzersiz gurmak (gözleg standart ýagdaýda gurulýar)
curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh \
  --with-embedder --no-browser

Sebäbi saňňy maşynlar URL arkaly salgylanýar, siz ýerli we daşarky saňňy maşynlary azatlyga goýup garyşdyryp bilersiňiz we birnäçe geçelgeleri bir paýlaşylan saňňy maşyna görkezip bilersiňiz.

Gurnamanyň hakykylygy nähili barlanýar

Hasap portalyňyzdaky şahsy baglanyşyk hemişe häzirki neşiri gurnaýar — bu adaty we ýeke-täk ýol. «Has täze wersiýa» saýlamak gerek däl: siz üpjün edijiniň önümçilik üçin çykaran gurnamasyny alýarsyňyz.

Her artefakt — ilkinji gurnamada-da, her täzelenişde-de — arhitekturaňyza görä tarball görnüşinde gelýär, onuň ýanynda bolsa .sha256 barlag jemi we .sig (cosign) goly durýar. Gurnaýjy hiç zady açmazdan öň ikisini-de barlaýar. Elde hiç zat barlamak gerek däl.

Garaşylýan netije: barlaglar sessiz geçýär we gurnama dowam edýär. Eger olaryň biri gabat gelmese, gurnaýjy ýalňyşlyk bilen saklanýar we işläp duran wersiýa degmeýär — zaýalanan ýa-da çalşyrylan faýl serwere düşmeýär.

Eger üpjün ediji sizi ir synag maksatnamasyna çagyran bolsa, kabinetiňizdäki «Gurnama» ekranynda saýlaýjy peýda bolýar we saýlanan warianta aýratyn baglanyşyk berilýär — serediň Nusga.

Gurnamany barlaň

Gurnama gutarandan soň, hyzmaty we taýarlyk nokadyny barlaň:

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

/healthz ýaşamagyny we wersiýasyny habar berýär; /readyz PostgreSQL-i barlaýar we yzyna gaýtarýar 503 maglumatlar bazasyna girip bolmaýan wagty. Gaplanan aihummer CLI hem üpjün edýär aihummer status we aihummer doctor çalt saglyk syny üçin.

Üstünlikli gurandan soň görjek zadyňyz: şu aihummer-gateway hyzmat etmek active (running), bir 200 ndan, den /healthz we /readyz, we başlangyç admin paroly bilen /home/.aihummer/etc/initial-admin-password.txt (root-suz gurnamada — ~/.aihummer/etc/initial-admin-password.txt) üçin ilkinji giris.

Öndüriş barlag sanawy

Bir gezeklik gurmak bu geçelgäni işledýär, ýöne ol henizem önümçilik üçin taýýar däl. Ony açmazdan öň, tamamla:

TLS — HTTPS-i gapydaky girişde (ýagdaýy yzyna dolandyrýan proksi / özüňiziň) tamamla şahadatnama); öňünden ynamdar bolmadyk ulgamlarda açyk porty hiç haçan açma.
🔴 Ters prokside WebSocket goldawyny işjeňleşdiriň. Ykjam we iş stoly programmasy şlýuza wss:// arkaly birigýär, şonuň üçin proksi Upgrade we Connection sözbaşylaryny geçirmeli. Bu sazlamasyz proksi 101 Switching Protocols ýerine 200 ýagdaýly adaty sahypany gaýtarýar — programma muny «hyzmat jogap bermeýär» diýip okaýar, emma şlýuz sagdyn we onuň žurnalynda ýekeje-de ýalňyşlyk ýok. Nginx Proxy Manager-de bu degişli Proxy Host üçin Websockets Support açary, adaty nginx-de bolsa — proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; location blogunda proxy_http_version 1.1 bilen bilelikde.

Bir buýruk bilen barlamak (200 däl, 101 garaşylýar):
```
curl -s -o /dev/null -w '%{http_code}\n' \
  -H 'Connection: Upgrade' -H 'Upgrade: websocket' \
  -H 'Sec-WebSocket-Version: 13' -H 'Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==' \
  https://siziň-domeniňiz/
```
Admin parolyny üýtget we poz initial-admin-password.txt; bellen tassyklama çykarýjy (AIHUMMER_OIDC_ISSUER / LDAP / SAML) mälim etmezden öň /admin/*.
Esasy açary we maglumatlar bazasyny ätiýaçlyk nusgalaryna alyň — rekord AIHUMMER_MASTER_KEY (syrlary ondan başga dikeldip bolmajak) we yzygiderli PostgreSQL ätiýaçlyk nusgalarynyň edilmegini gurnadyň.
Hakyky modeli simlemek — toplum AIHUMMER_LLM_* (ýa-da BYOK); onuňsyz jogaplar gelýär deterministik mokdan.
Iň azlygy bilen bir kanala birikdir (Telegram bilen başlap) we oňa bir agent birikdir.

Gör Ilk girmek, Konfigurasiýa we Ekinler we DP mälimatlar üçin.

Eger işlemän bolsa

«baglanyşyk eýýäm ulanyldy» / gurnama ikinji gezek başlamaýar — baglanyşyk bir gezeklik we öňki synanyşyk ony eýýäm sarp edipdir. Kabinetdäki «Gurnama» ekranynda täze baglanyşyk alyň we buýrugy gaýtadan işlediň.
curl: (22) … 404 ýa-da «baglanyşyk nädogry» — baglanyşyk doly däl göçürilipdir ýa-da möhleti geçipdir. Çäre şol bir — täze baglanyşyk.
goldawlanmaýan arhitekturanyň — gurnama Linux x86_64 we arm64-i goldaýar; Başga platformalar üçin bir paket ýok.
/readyz gaýdyp gelýär 503 — gapy PostgreSQL-i görüp bilmeýär. Barla AIHUMMER_DATABASE_URL, maglumatyň elýeterliligi, we şol pgcrypto uzaldyş döredilýär (CREATE EXTENSION IF NOT EXISTS pgcrypto;).
Hyzmat başlamaýar — barlamak systemctl status aihummer-gateway we journalctl -u aihummer-gateway; çalt barlag üçin işletmek aihummer doctor.
Sudo ulanmadan gurnaldy, hyzmatlar çykandan soň togtady — giç galmagy ýola goý: loginctl enable-linger $USER (seret tamyrsyz).
Gol tassyklamasy üýtgeşik boldy — gurmagy dowam etdirmäň; soňra täzeden synanyşyň ýa-da täze baglanyşygy alyň. Artefakt hemişe onuň bilen barlagdan geçirilýär .sha256 we kosign .sig.

Indi nire?

Ilkinji işleş: görüň Ilk girmek gaýtadan almak ilkinji administratoryň açar sözi /home/.aihummer/etc/initial-admin-password.txt (root-suz gurnamada — ~/.aihummer/etc/initial-admin-password.txt).
Ýerlestirmäni sazla: oka Konfigurasiýa.
Gidennetilen ilkinji işledişi isleýärsiňizmi? Ulanyň Çalt başlamak.