დაყენება

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

/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

loginctl enable-linger $USER

# დააინსტალირეთ gateway ემბედერით, ბრაუზერის გარეშე (ძებნა ნაგულისხმევად ინსტალირდება)
curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh \
  --with-embedder --no-browser

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

ამყარებს AiHummer **მასპინძლისთვის ბუნებრივი**. ინსტალაცია იწყება თქვენს პირად კაბინეტში [my.aihummer.ru](https://my.aihummer.ru): თქვენ იწერთ ხელს, იღებთ **პირადი ბმული დაყენებისთვის** და გამოიყენეთ ერთი ბრძანება თქვენს სერვერზე. ინსტალაციის სკრიპტი ჩამოსდებს ხელმოწერილ პაკეტს თქვენი არქიტექტურისთვის და ადგენს ერთ ინსტალაციის ძირითადი ფოლდერს `~/.aihummer` (მომხმარებლის სახლის კატალოგში, რომელმაც დააწესა ინსტალატორი), რეგისტრირებს systemd-ეს ერთეულებს და, სურვილის შემთხვევაში, ამზადებს საიდქარს. ამ პროცესში კონტეინერები არსად არის. > [!NOTE] > ეს არის ინსტალაცია ადგილობრივ ჰოსტზე — რელიზის არქივი, რომელიც მუშაობს systemd-ის ქვეშ, **არა** > Docker. ჭიშკარი, გვერდითი მანქანები და პლაგინები თითოეული გაშვებულია როგორც საკუთარი systemd > სერვისი. > [!NOTE] > **რა გჭირდებათ დაწყებამდე:** > > - ა **ლინუქსი** სერვერი (x86_64 ან arm64), რომლისთვისაც შეგიძლიათ დაკავშირება SSH-ის საშუალებით; > - **`sudo`** უფლებები (ან მზადყოფნა დააყენოთ rootless — იხ. ქვემოთ); > - **PostgreSQL** ს `pgcrypto` გაფართოება — ან დაუშვათ დაყენებელს დააკონფიგურიროს > კლასტერ მომხმარებლის რეჟიმში (რუტის გარეშე რეჟიმში იგი ამას თავისით აკეთებს); > - გაგზავნა მიიღე [my.aihummer.ru](https://my.aihummer.ru) გა მიიღოთ თქვენი პირადი > ინსტალაციის ლინკი. > > სრული მოთხოვნების სია მდებარეობს > [მოთხოვნები](/ka/v1.0/getting-started/requirements) გვერდი. ## ნაბიჯი 1: მიიღეთ თქვენი პირადი ინსტალაციის ბმული საერთო გამოსაყენებელი ინსტალაციის სკრიპტი არ არსებობს — ინსტალაციის ლინკი: **პირადი** და გაიცემა თქვენს ანგარიშის პორტალზე: 1. რეგისტრაცია [my.aihummer.ru](https://my.aihummer.ru) (ტელეფონის ნომერი + პაროლი; საჭიროა ელექტრონული ფოსტაც). 2. გახსენი **დაყენება** ეკრანზე დააჭირეთ «პერსონალური ბმულის მიღება ინსტალაციისთვის». 3. პორტალი აჩვენებს შესრულებისთვის მზად ბრძანებას თქვენს პირად ბმულთან ერთად. სრულფასოვანი ინფორმაცია პორტალის შესახებ (ინფორმაცია გადახდების, დოკუმენტების, გეგმების შესახებ) მდებარეობს [პერსონალური ოფისი](/ka/v1.0/commercial/personal-account) გვერდი. ## ნაბიჯი 2: დაყენება ერთ ბრძანებით დააკოპირეთ ბრძანება „ ინსტალაციის“ ეკრანიდან და ჩაიტვირთეთ ის თქვენს სერვერზე (Linux x86_64/arm64): ```bash curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh ``` პირადი ბმული გამოიყურება როგორც `https://my.aihummer.ru/dl/<token>/install.sh` და დაკავშირებულია თქვენს ანგარიშთან. > [!IMPORTANT] > **ბმული ერთჯერადია: ის მუშაობს ზუსტად ერთი ინსტალაციისთვის.** როგორც კი > ინსტალატორმა მისი მეშვეობით ჩამოტვირთა `install.sh`, ბმული დახარჯულად > ითვლება. იმავე ბრძანების ხელახლა გაშვება დააბრუნებს შეცდომას «ბმული უკვე > გამოყენებულია» — ეს ხარვეზი კი არა, დაცვაა. **რა უნდა გააკეთოთ:** გახსენით > პირად კაბინეტში ეკრანი «დაყენება» და მიიღეთ ახალი ბმული — ეს უფასო და > მყისიერია. > > ვადა **30 დღე** ეხება არა ხელახლა ინსტალაციას, არამედ არტეფაქტების > ჩამოტვირთვას: უკვე დაყენებული ეგზემპლარი აგრძელებს განახლებას თავისი ბმულით > მას შემდეგაც, რაც ბმული ინსტალაციაზე დაიხარჯა. სკრიპტი ახსნობს თქვენი პროცესორის არქიტექტურას, იტვირთება შესაბამისი პაკეტი მისთანაპი `.sha256` კონტროლური ჯამი და თანამოწერა `.sig` ხელმოწერა, აღინიშნება ორივე, ახსნის ინსტალაციის ბირთვს და რეგისტრირდება შლიუს სერვისი. იხილეთ [ცვლილებების ჟურნალი](/ka/v1.0/changelog) ამ წყვეტისათვის. ასევე პირადი ბმული **ხრიკავს მაგალითს თქვენს კლიენტის პორტალის ანგარიშთან**: ინსტალატორი ინახავს ტოკენს ბმულიდან, ინტანსი უგზავნის მას მომპოვებელზე რეგისტრაციის პირველ დროს, ხოლო პორტალი ავტომატურად აკავშირებს ინტანსს თქვენს ანგარიშთან. თქვენი E-mail დაუყოვნებლივ ხდება ნიმუში **დამოწმებული კონტაქტი** — ვებ ინტერფეისში არ არსებობს ცალკეული ნაბიჯი „ელექტრონული ფოსტის დანართვა და შემოწმება“, და ლიცენზია მიეწოდება ხელით მოქმედებების გარეშე. > [!WARNING] > თქვენი პირადი ბმული არის თქვენი გასაზრდელი გასაღები. ნუ გამოაქვეყნებთ მას: ნებისმიერი > ბმულის შენარჩუნებით, შესაძლებელია აღინიშნოს კრებულები თქვენი სახელით ტოკენის ვადის გასვლისდეც. ## ფესვის მარკირების დაყენება ყველაფერი ერთ დირექტორიაშია. **რომელში ზუსტად — დამოკიდებულია იმაზე, როგორ გაუშვით ინსტალატორი:** | როგორ დაყენდა | ინსტალაციის ძირი | კონფიგურაცია | ვისი სახელით მუშაობს სერვისი | |---|---|---|---| | ჩვეულებრივი დაყენება (`sudo`-თი) | `/home/.aihummer` | `/etc/aihummer/gateway.env` | ცალკე სამსახურებრივი ანგარიში `aihummer` | | root-ის გარეშე (rootless) | `~/.aihummer` | `~/.aihummer/etc/gateway.env` | თქვენი მომხმარებელი | ჩვეულებრივი დაყენება ფაილებს თქვენს საშინაო დირექტორიაში **არ ათავსებს** და სერვისს თქვენი სახელით **არ უშვებს**: მისთვის იქმნება ცალკე, არაპრივილეგირებული მომხმარებელი `aihummer`. ეს განზრახ არის ასე — სერვისის კომპრომეტირება თქვენს პირად ფაილებზე წვდომას არ იძლევა. ძირის შიგნით სტრუქტურა ორივე რეჟიმში ერთნაირია (ქვემოთ ნაჩვენებია ჩვეულებრივი დაყენება): ```text /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-ის უნიტის ფაილები, გენერირებული `systemd/` არის **შექმნილია სიმბოლური კავშირი `/etc/systemd/system/`**, ამიტომ მათ ებრძვიან რეგულარული `systemctl` კომანდები. ## უსხუნა ინსტალაცია `sudo`/root-სិადოები არ სჭირდება. თუ შესრულებთ ინსტალაციის ბრძანებას **სუდოს გარეშე**, ინსტალატორი გადადის root-ის გარეშე რეჟიმზე: ერთეულები რეგისტრირდება `systemd --user` რეგიონი (ფაილები-ში `~/.config/systemd/user`), ის `aihummer` CLI და cosign გამოჩნდებიან `~/.aihummer/bin`, და თუ `AIHUMMER_DATABASE_URL` არ არის ინსტალირებული, ინსტალატორი აყენებს PostgreSQL კლასტერს მომხმარებლის რეჟიმში ინსტალაციის ძირითადი დირექტორიის შიგნით. სერვისები მართავენ `systemctl --user ...`ამ მიზნით, რომ სერვისი გაშვებული იყოს სისტემის ჩატვირთვისას (არა მხოლოდ მომხმარებლის შესვლისას), ჩართეთ დაგვიანება: ```bash loginctl enable-linger $USER ``` ## ქუჩოს შერჩევა ხელმისაწვდომი მედია მხარდაჭერა — **STT (faster-whisper), TTS (edge-tts) და ვიდეო — ინსტალაცია ყუთიდან**, კითხვების ან გაფრთხილების გარეშე: ორინი მხარიანი ხმის კავშირი პირდაპირ მუშაობს. ნებისმიერ მათგანს შეიძლება გამორთვა გარემოს ცვლადებით `AIHUMMER_SKIP_STT=1`, `AIHUMMER_SKIP_TTS=1`, `AIHUMMER_SKIP_VIDEO=1`. ვებ-ძებნა (SearXNG) და ბრაუზერი (CloakBrowser) **ჩაშენებულია ხელმოწერილ ბანდლში** და ნაგულისხმევად ოფლაინ ინსტალირდება — ინსტალატორი მათ შესახებ აღარ კითხულობს. ამ ქცევის შეცვლა შესაძლებელია დროშებით — ეს არის სრული სია: | დროშა | ეფექტი | |---|---| | `--no-search` / `--no-browser` | ამ სერვისის გამოტოვება | | `--external-search=URL` / `--external-browser=URL` | გამოიყენეთ არსებული სერვისი ამ URL-ზე ინსტალაციის ნაცვლად | | `--browser-engine=cloak\|chrome` | ბრაუზერის ძრავა (ნაგულისხმევად `cloak`) | | `--with-search` / `--with-browser` | ზედმეტია v1.0.14-იდან — ეს უკვე ნაგულისხმევი ქცევაა | | `--with-embedder` | დააყენეთ სემანტიკური ემბედერი (**არჩევითი**: ჩამოტვირთავს PyTorch — ასობით მბ) | ძებნა და ბრაუზერი ინსტალირდება tty-ს გარეშეც: მათი შიგთავსი ბანდლიდან მოდის და ინტერნეტთან წვდომა ამისთვის საჭირო არ არის. ორივეს ინსტალაცია **არ არის ბლოკირებადი** — თუ შიგთავსი აკლია ან Python-ის ვერსია მხარდაუჭერელია, სერვისი უბრალოდ დაუყენებელი რჩება და ინსტალაცია არასოდეს წყდება. ჩაშენებული მოდულიც შეიძლება ჩართულ იქნეს `AIHUMMER_WITH_EMBEDDER=1`; მის გარეშე მეხსიერება მუშაობს ლექსიკური შესაბამისობების ძიების პრინციპზე. ინტერფეისის ენა განისაზღვრება შემდეგით `AIHUMMER_LANG=ru|en` (უპირისპირეს შემთხვევაში ინსტალატორი სთხოვს tty-ში). PostgreSQL–თან კავშირი მოთხოვნილია tty-ში; არაინტერაქტიული ინსტალაციისთვის დააყენეთ `AIHUMMER_DATABASE_URL` წინა მხრივ. tty-ზე ინსტალატორი ასევე სთავაზობს აღდგენას სარეზერვო ასლიდან. ```bash # დააინსტალირეთ gateway ემბედერით, ბრაუზერის გარეშე (ძებნა ნაგულისხმევად ინსტალირდება) curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh \ --with-embedder --no-browser ``` მაშინ როცა საიდქარები მიმართავენ URL–ის მიხედვით, შეგიძლიათ თავისუფლად აურიოთ ნატიური და გარე, ასევე რამდენიმე გეიტვეი მიიყვანოთ ერთ საერთო საიდქარზე. ## როგორ მოწმდება ბილდის ნამდვილობა პირადი ბმული პირადი კაბინეტიდან ყოველთვის აყენებს **მიმდინარე გამოშვებას** — ეს სტანდარტული და ერთადერთი გზაა. «უფრო ახალი ვერსიის» არჩევა საჭირო არ არის: თქვენ იღებთ იმ ბილდს, რომელიც მომწოდებელმა ექსპლუატაციისთვის გამოუშვა. ყოველი არტეფაქტი — როგორც პირველი დაყენებისას, ისე ყოველი განახლებისას — მოდის tarball-ის სახით თქვენი არქიტექტურისთვის, გვერდით კი დევს საკონტროლო ჯამი `.sha256` და ხელმოწერა `.sig` (cosign). ინსტალატორი ამოწმებს **ორივეს** მანამ, სანამ რამეს გახსნის. ხელით არაფრის შემოწმება არ არის საჭირო. **მოსალოდნელი შედეგი:** შემოწმებები ჩუმად გაივლის და დაყენება გრძელდება. თუ ერთი მაინც არ დაემთხვა, ინსტალატორი შეჩერდება შეცდომით და უკვე მომუშავე ვერსიას **არ შეეხება** — დაზიანებული ან შეცვლილი ფაილი სერვერზე არ მოხვდება. თუ მომწოდებელმა თქვენ ადრეული ტესტირების პროგრამაში მოგიწვიათ, პირად კაბინეტში ეკრანზე «დაყენება» გამოჩნდება გადამრთველი და არჩეული ვარიანტისთვის გამოიცემა ცალკე ბმული — იხ. [ეგზემპლარი](/ka/v1.0/portal/instance). ## გაამოწმეთ ინსტალაცია ინსტალაციის დასრულების შემდეგ, შეამოწმეთ სერვისი და მზადყოფნის ბოლო წერტილი: ```bash systemctl status aihummer-gateway curl -fsS http://localhost:8780/healthz curl -fsS http://localhost:8780/readyz ``` `/healthz` მინიატიურა სიცოცხლისუნარიანობასა და ვერსიაზე; `/readyz` ამოწმებს PostgreSQL-ს და აბრუნებს `503` მინი მონაცემთა ბაზა მიუწვდომელია. კომპლექტში `aihummer` CLI ასევე უზრუნველყოფს `aihummer status` და `aihummer doctor` ჯანმრთელობის მდგომარეობის სწრაფი მიმოხილვისთვის. **რას დაინახავთ წარმატებული ინსტალაციის შემდეგ:** ეს `aihummer-gateway` მომსახურება `active (running)`, კი `200` დან `/healthz` და `/readyz`, და ადმინისტრატორის საწყისი პაროლი არის `/home/.aihummer/etc/initial-admin-password.txt` (root-ის გარეშე დაყენებისას — `~/.aihummer/etc/initial-admin-password.txt`) თვის [პირველი შესვლა](/ka/v1.0/getting-started/first-login). ## მწარმოებლობის კონტროლის სია ერთმა ინსტალაციის ბრძანებამ გაიშვარა ჭიშკარი, მაგრამ ეს **მოუმზადებელია წარმოებისთვის**. სანამ ეს აჩვენოთ, დაასრულეთ: - **TLS** — დაასრულეთ HTTPS გეიტვის წინ (პროგქსი უკუგამოცემაში / თქვენი საკუთარი) სერტიფიკატი); არასოდეს გახსნათ ჩვეულებრივი პორტი დაუჯერებელ ქსელში. - 🔴 **ჩართეთ WebSocket-ის მხარდაჭერა უკუპროქსიზე.** მობილური და დესკტოპ აპლიკაცია კარიბჭეს უკავშირდება `wss://`-ით, ამიტომ პროქსიმ უნდა გაატაროს სათაურები `Upgrade` და `Connection`. ამ პარამეტრის გარეშე პროქსი `101 Switching Protocols`-ის ნაცვლად აბრუნებს **ჩვეულებრივ გვერდს 200 სტატუსით** — აპლიკაცია ამას კითხულობს როგორც «სერვისი არ პასუხობს», თუმცა კარიბჭე გამართულია და მის ჟურნალში არც ერთი შეცდომა არ არის. Nginx Proxy Manager-ში ეს არის შესაბამისი Proxy Host-ის გადამრთველი **Websockets Support**, ჩვეულებრივ nginx-ში — `proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";` `location` ბლოკში `proxy_http_version 1.1`-თან ერთად. შემოწმება ერთი ბრძანებით (მოსალოდნელია `101`, და არა `200`): ```bash 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://თქვენი-დომენი/ ``` - **გააახლებთ ადმინისტრატორის პაროლს** და წაშლა `initial-admin-password.txt`; დაამონტაჟე ავტენტიფიკაციის გამთვლელი (`AIHUMMER_OIDC_ISSUER` / LDAP / SAML) გამოყენებამდე `/admin/*`. - **შეინახეთ მთავარი კლავიატურა და მონაცემთა ბაზა** — ჩანაწერი `AIHUMMER_MASTER_KEY` (საიდუმლოები არაირეკვალიზირებადია მის გარეშე) და დააყენეთ რეგულარული PostgreSQL-ის სარეზერვო ასლის შექმნა. - **გააკეთეთ ნამდვილი მოდელი** — დააყენოს `AIHUMMER_LLM_*` (ან BYOK); მის გარეშე პასუხები მოდის დეტერმინირებული ნაკადისგან. - **შეაერთეთ მინიმუმ ერთი არხი** (ტელეგრამი დაიწყეთ) და დაუკავშირეთ მას აგენტი. ხედვა [პირველი შესვლა](/ka/v1.0/getting-started/first-login), [კონფიგურაცია](/ka/v1.0/getting-started/configuration) და [სარეზერვო კოპირება და საგანგებო აღდგენა](/ka/v1.0/operations/backups-dr) დეტალებისთვის. ## თუ ეს არ მუშაობს - **«ბმული უკვე გამოყენებულია» / დაყენება მეორედ არ იშვება** — ბმული ერთჯერადია და წინა მცდელობამ ის უკვე დახარჯა. მიიღეთ ახალი ეკრანზე «დაყენება» კაბინეტში და ბრძანება ხელახლა გაუშვით. - **`curl: (22) … 404` ან «ბმული არასწორია»** — ბმული არასრულად დაკოპირდა ან მისი ვადა გავიდა. წამალი იგივეა — ახალი ბმული. - **მოუმხრობელი არქიტექტურა** — ინსტალაცია მხარს უჭერს Linux x86_64 და arm64; სხვა პლატფორმებისთვის პაკეტი არ არსებობს. - **`/readyz` აბრუნებს `503`** — სლიუზი PostgreSQL-ს ვერ ხედავს. შეამოწმეთ `AIHUMMER_DATABASE_URL`, მონაცემთა ბაზის ხელმისაწვდომობა და რა `pgcrypto` გაფართოვება შეიქმნა (`CREATE EXTENSION IF NOT EXISTS pgcrypto;`). - **სერვისი არ დაწყებულა** — შემოწმება `systemctl status aihummer-gateway` და `journalctl -u aihummer-gateway`; სწრაფი დიაგნოზისთვის ჩართეთ `aihummer doctor`. - **დაყენებულია sudo-ის გარეშე, სერვისები გაითიშება ავტორიზაციის შემდეგ** — ჩართეთ დაგვიანება: `loginctl enable-linger $USER` (იხ. [უსაფუძვლო](#rootless-install)). - **ხელმოწერის შემოწმება ვერ განხორციელდა** — არ გააგრძელოთ ინსტალაცია; სცადეთ მოგვიანებით კვლავ ან მიიღეთ ახალი ლინკი. არტეფაქტი ყოველთვის შემოწმდება მისი შესაბამისობის მიხედვით `.sha256` და საერთო ავტორი `.sig`. ## სად შემდეგ? - პირველი გამოცემა: იხ. [პირველი შესვლა](/ka/v1.0/getting-started/first-login) ამოღება ადმინისტრატორის თავდაპირველი პაროლი `/home/.aihummer/etc/initial-admin-password.txt` (root-ის გარეშე დაყენებისას — `~/.aihummer/etc/initial-admin-password.txt`). - დაწყების პარამეტრები: წაკითხვა [კონფიგურაცია](/ka/v1.0/getting-started/configuration). - გინდათ პირველი სირბილი გიდთან ერთად? გამოიყენეთ [სწრაფი დაწყება](/ka/v1.0/getting-started/quickstart).