Տեղադրում

curl -fsSL "<տեղադրման անձնական հղում>" | sudo bash

~/.aihummer/
├── bin/        gateway binary-ն և aihummer CLI-ը
├── etc/        կարգավորում (gateway.env)
├── share/      ստատիկ ակտիվներ (ադմին UI, վիջեթ)
├── sidecars/   ընտրովի STT/TTS/և այլն ծառայություններ
├── plugins/    տեղադրված marketplace plugin-ներ
├── systemd/    unit ֆայլեր (symlink-ներ դեպի /etc/systemd/system)
├── state/      runtime վիճակ
├── data/       blob/մեդիա պահեստ
└── logs/       ծառայությունների լոգեր

loginctl enable-linger $USER

# Install the gateway with native search and the embedder, skip the browser
curl -fsSL "<տեղադրման անձնական հղում>" | sudo bash -s -- \
  --with-search --with-embedder --no-browser

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

AiHummer-ը տեղադրվում է **host-native**։ Տեղադրումը սկսվում է անձնական գրասենյակում՝ [my.aihummer.ru](https://my.aihummer.ru). դուք գրանցվում եք, ստանում **տեղադրման անձնական հղում** և ձեր սերվերի վրա գործարկում մեկ հրաման։ Տեղադրման սկրիպտը ներբեռնում է ստորագրված, ըստ-ճարտարապետության փաթեթը, դասավորում մեկ տեղադրման արմատ `~/.aihummer`-ի տակ (տեղադրիչը գործարկած օգտատիրոջ home տեղեկատուում), գրանցում systemd unit-ները և անհրաժեշտության դեպքում ապահովում sidecar-ները։ Այս գործընթացում ոչ մի տեղ կոնտեյներներ չկան։ > [!NOTE] > Սա host-native տեղադրում է — systemd-ի տակ աշխատող թողարկման tarball, **այլ ոչ** > Docker։ Gateway-ը, sidecar-ները և plugin-ները յուրաքանչյուրը աշխատում են որպես իրենց > սեփական systemd ծառայություն։ ## Քայլ 1. ստացեք տեղադրման անձնական հղումը Հրապարակային տեղադրման սկրիպտ այլևս չկա — տեղադրման հղումը **անձնական է** և տրվում է անձնական գրասենյակում. 1. Գրանցվեք [my.aihummer.ru](https://my.aihummer.ru)-ում (email + գաղտնաբառ, հաստատում նամակի 6-նիշանոց կոդով)։ 2. Բացեք **«Տեղադրում»** էկրանը և սեղմեք «Ստանալ տեղադրման անձնական հղում»։ 3. Գրասենյակը ցույց կտա պատրաստի հրամանը ձեր անձնական հղումով։ Բուն գրասենյակի մասին ավելին (վավերապայմաններ, փաստաթղթեր, սակագներ) — էջում [Անձնական գրասենյակ](/hy/v1.0/commercial/personal-account)։ ## Քայլ 2. տեղադրում մեկ հրամանով Պատճենեք հրամանը «Տեղադրում» էկրանից և գործարկեք այն սերվերի վրա (Linux x86_64/arm64). ```bash curl -fsSL "<տեղադրման անձնական հղում>" | sudo bash ``` Անձնական հղումն ունի `https://my.aihummer.ru/dl/<token>/install.sh` տեսքը, կապված է ձեր հաշվին և գործում է **30 օր** — ժամկետը լրանալուց հետո պարզապես ստացեք նորը նույն էկրանում։ Արդեն տեղադրված instance-ը շարունակում է թարմանալ իր հղումով նաև ժամկետի ավարտից հետո։ Սկրիպտը որոշում է CPU ճարտարապետությունը, ներբեռնում համապատասխան փաթեթը իր `.sha256` checksum-ի և cosign `.sig` ստորագրության հետ միասին, ստուգում երկուսն էլ, բացում տեղադրման արմատը և գրանցում gateway ծառայությունը։ Ընթացիկ թողարկումը՝ [Փոփոխությունների մատյանում](/hy/v1.0/changelog)։ > [!WARNING] > Անձնական հղումը ձեր բանալին է դեպի դիստրիբուտիվը։ Մի հրապարակեք այն. ով > ունի հղումը, կարող է ներբեռնել build-եր ձեր անունից, մինչև token-ի > գործողության ժամկետը լրանա։ ## Տեղադրման արմատի դասավորություն Ամեն ինչ գտնվում է մեկ տեղեկատուի՝ `~/.aihummer`-ի տակ — տեղադրիչը գործարկած օգտատիրոջ home տեղեկատուում (`sudo`-ի տակ դա `sudo`-ն կանչած օգտատերն է, ոչ թե root. օրինակ՝ `/home/ivan/.aihummer`)։ Ֆայլերը պատկանում են այդ օգտատիրոջը, և ծառայություններն աշխատում են նրա անունից. ```text ~/.aihummer/ ├── bin/ gateway binary-ն և aihummer CLI-ը ├── etc/ կարգավորում (gateway.env) ├── share/ ստատիկ ակտիվներ (ադմին UI, վիջեթ) ├── sidecars/ ընտրովի STT/TTS/և այլն ծառայություններ ├── plugins/ տեղադրված marketplace plugin-ներ ├── systemd/ unit ֆայլեր (symlink-ներ դեպի /etc/systemd/system) ├── state/ runtime վիճակ ├── data/ blob/մեդիա պահեստ └── logs/ ծառայությունների լոգեր ``` `systemd/`-ի տակ գեներացված systemd unit ֆայլերը **symlink-ով կապված են `/etc/systemd/system/`-ի հետ**, ուստի դրանք կառավարվում են սովորական `systemctl` հրամաններով։ ## Տեղադրում առանց root-ի (rootless) `sudo`/root իրավունքները պարտադիր չեն։ Եթե տեղադրման հրամանը գործարկեք **առանց sudo-ի**, տեղադրիչն անցնում է rootless ռեժիմի. unit-ները գրանցվում են օգտատիրական `systemd --user` scope-ում (ֆայլերը՝ `~/.config/systemd/user`-ում), `aihummer` CLI-ը և cosign-ը դրվում են `~/.aihummer/bin`-ում, իսկ եթե `AIHUMMER_DATABASE_URL`-ը սահմանված չէ, տեղադրիչը տեղադրման արմատի ներսում ապահովում է օգտատիրական (user-mode) PostgreSQL կլաստեր։ Ծառայությունները կառավարվում են `systemctl --user ...` հրամաններով։ Որպեսզի ծառայությունները գործարկվեն հոսթի բեռնման ժամանակ (և ոչ միայն օգտատիրոջ մուտքի ժամանակ), միացրեք lingering-ը. ```bash loginctl enable-linger $USER ``` ## Sidecar-ների ընտրություն Թեթև մեդիա sidecar-ները — **STT (faster-whisper), TTS (edge-tts) և video — տեղադրվում են տուփից դուրս**, առանց հարցերի ու դրոշների. ձայնային «այնտեղ-ու-հետ» շրջանն աշխատում է անմիջապես։ Դրանցից ցանկացածը կարելի է անջատել `AIHUMMER_SKIP_STT=1`, `AIHUMMER_SKIP_TTS=1`, `AIHUMMER_SKIP_VIDEO=1` միջավայրի փոփոխականներով։ Մնացած sidecar-ների մասին տեղադրիչը հարցնում է ինտերակտիվ (tty-ի վրա), կամ դրանք կառավարվում են դրոշներով — ահա ամբողջական ցանկը. | Դրոշ | Ազդեցություն | |---|---| | `--with-search` / `--with-browser` | Տեղադրել SearXNG / headless Chrome native-ով, առանց հարցի | | `--external-search=URL` / `--external-browser=URL` | Տեղադրելու փոխարեն օգտագործել գոյություն ունեցող ծառայությունն այս URL-ով | | `--no-search` / `--no-browser` | Բաց թողնել այս sidecar-ը | | `--with-embedder` | Տեղադրել իմաստային embedder-ը (**opt-in**. քաշում է PyTorch — հարյուրավոր ՄԲ) | Առանց tty-ի և առանց դրոշի search/browser-ը բաց են թողնվում։ Embedder-ը միանում է նաև `AIHUMMER_WITH_EMBEDDER=1` փոփոխականով. առանց դրա հիշողությունն աշխատում է բառային fallback որոնման վրա։ Ինտերֆեյսի լեզուն սահմանում է `AIHUMMER_LANG=ru|en`-ը (հակառակ դեպքում տեղադրիչը կհարցնի tty-ի վրա)։ PostgreSQL-ի միացումը հարցվում է tty-ի վրա. ոչ ինտերակտիվ տեղադրման համար նախապես սահմանեք `AIHUMMER_DATABASE_URL`-ը։ Tty-ի վրա տեղադրիչը նաև առաջարկում է վերականգնում պահուստային պատճենից։ ```bash # Install the gateway with native search and the embedder, skip the browser curl -fsSL "<տեղադրման անձնական հղում>" | sudo bash -s -- \ --with-search --with-embedder --no-browser ``` Քանի որ sidecar-ները հասանելի են URL-ով, կարող եք ազատորեն խառնել native-ը և external-ը և մի քանի gateway ուղղել մեկ ընդհանուր sidecar-ի։ ## Թողարկման ալիքներ AiHummer-ն առաքվում է չորս ալիքով. **stable**, **alfa**, **beta** և **dev**։ Անձնական գրասենյակի անձնական հղումը տեղադրում է **stable** ալիքը — սա ստանդարտ ուղին է բոլոր օգտատերերի համար։ | Ալիք | Հասանելիություն | Ապակոդավորված | |---|---|---| | stable | Անձնական հղում անձնական գրասենյակից | — | | alfa | Տրվում է վենդորի կողմից (թեստավորման ծրագրեր) | Այո | | beta | Տրվում է վենդորի կողմից (թեստավորման ծրագրեր) | Այո | | dev | Տրվում է վենդորի կողմից | Ոչ (unobfuscated) | alfa/beta/dev ալիքները key-gated են և նախատեսված են վաղ թեստավորման ծրագրերի մասնակիցների համար — դրանց հասանելիությունը վենդորը տալիս է անհատապես։ Բոլոր ալիքների artifact-ները տարածվում են որպես ըստ-ճարտարապետության tarball՝ իրենց `.sha256` checksum-ի և cosign `.sig` ստորագրության հետ միասին — երկուսն էլ ստուգվում են տեղադրման և յուրաքանչյուր թարմացման ժամանակ։ ## Տեղադրման ստուգում Տեղադրիչի ավարտից հետո ստուգեք ծառայությունը և պատրաստության վերջնակետը. ```bash systemctl status aihummer-gateway curl -fsS http://localhost:8780/healthz curl -fsS http://localhost:8780/readyz ``` `/healthz`-ը հաղորդում է liveness-ը և տարբերակը. `/readyz`-ը ստուգում է PostgreSQL-ը և վերադարձնում `503`, քանի դեռ տվյալների բազան հասանելի չէ։ Փաթեթավորված `aihummer` CLI-ը նաև ներկայացնում է `aihummer status` և `aihummer doctor` առողջության արագ ընդհանուր պատկերի համար։ ## Ուր հետո - Առաջին գործարկում. տես [Առաջին մուտք](/hy/v1.0/getting-started/first-login)՝ ադմինիստրատորի սկզբնական գաղտնաբառը `~/.aihummer/etc/initial-admin-password.txt` ֆայլից ստանալու համար։ - Կարգաբերեք տեղակայումը. կարդացեք [Կարգավորում](/hy/v1.0/getting-started/configuration)։ - Ուզու՞մ եք անցնել առաջին գործարկման միջով քայլ առ քայլ։ Օգտագործեք [Արագ մեկնարկ](/hy/v1.0/getting-started/quickstart)։