ინსტალაცია

curl -fsSL "<ინსტალაციის პერსონალური ბმული>" | sudo bash

~/.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

loginctl enable-linger $USER

# Install the gateway with native search and embedder, no 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 ინსტალირდება **ჰოსტ-მშობლიურად**. ინსტალაცია იწყება პირად კაბინეტში [my.aihummer.ru](https://my.aihummer.ru): რეგისტრირდებით, იღებთ **ინსტალაციის პერსონალურ ბმულს** და უშვებთ ერთ ბრძანებას თქვენს სერვერზე. ინსტალაციის სკრიპტი იღებს ხელმოწერილ, საჭირო არქიტექტურის ნაკრებს, აწყობს ერთიან ინსტალაციის ფესვს `~/.aihummer`-ის ქვეშ (ინსტალერის გამშვები მომხმარებლის სახლის დირექტორიაში), არეგისტრირებს systemd ერთეულებს და, საჭიროებისამებრ, შლის sidecar-ებს. ამ პროცესში არსად არ არის კონტეინერები. > [!NOTE] > ეს არის ჰოსტ-მშობლიური ინსტალაცია — გამოშვების tarball, რომელიც systemd-ის ქვეშ > მუშაობს, **არა** Docker. gateway, sidecar-ები და დანამატები თითოეული მუშაობს > საკუთარ systemd სერვისად. ## ნაბიჯი 1: მიიღეთ ინსტალაციის პერსონალური ბმული საჯარო ინსტალაციის სკრიპტი აღარ არსებობს — ინსტალაციის ბმული **პერსონალურია** და გაიცემა პირად კაბინეტში: 1. დარეგისტრირდით [my.aihummer.ru](https://my.aihummer.ru)-ზე (email + პაროლი, დადასტურება წერილიდან მიღებული 6-ნიშნა კოდით). 2. გახსენით ეკრანი **«ინსტალაცია»** და დააჭირეთ «ინსტალაციის პერსონალური ბმულის მიღება». 3. კაბინეტი გაჩვენებთ მზა ბრძანებას თქვენი პერსონალური ბმულით. დაწვრილებით თავად კაბინეტის შესახებ (რეკვიზიტები, დოკუმენტები, ტარიფები) — გვერდზე [პირადი კაბინეტი](/ka/v1.0/commercial/personal-account). ## ნაბიჯი 2: ინსტალაცია ერთი ბრძანებით დააკოპირეთ ბრძანება ეკრანიდან «ინსტალაცია» და გაუშვით ის სერვერზე (Linux x86_64/arm64): ```bash curl -fsSL "<ინსტალაციის პერსონალური ბმული>" | sudo bash ``` პერსონალურ ბმულს აქვს სახე `https://my.aihummer.ru/dl/<token>/install.sh`, მიბმულია თქვენს ანგარიშზე და მოქმედებს **30 დღე** — ვადის გასვლის შემდეგ უბრალოდ მიიღეთ ახალი იმავე ეკრანზე. უკვე დაინსტალირებული ინსტანსი აგრძელებს განახლებას თავისი ბმულით ვადის გასვლის შემდეგაც. სკრიპტი ამოიცნობს CPU-ის არქიტექტურას, ჩამოტვირთავს შესაბამის ნაკრებს მის `.sha256` checksum-სა და cosign `.sig` ხელმოწერასთან ერთად, გადაამოწმებს ორივეს, ამოალაგებს ინსტალაციის ფესვს და დაარეგისტრირებს gateway სერვისს. მიმდინარე გამოშვება — [ცვლილებების ჟურნალში](/ka/v1.0/changelog). > [!WARNING] > პერსონალური ბმული თქვენი გასაღებია დისტრიბუტივისკენ. ნუ გამოაქვეყნებთ მას: > ნებისმიერს, ვისაც ბმული აქვს, შეუძლია ბილდების ჩამოტვირთვა თქვენი სახელით, > ვიდრე ტოკენის მოქმედების ვადა არ ამოიწურება. ## ინსტალაციის ფესვის განლაგება ყველაფერი ცხოვრობს ერთ დირექტორიაში, `~/.aihummer` — ინსტალერის გამშვები მომხმარებლის სახლის დირექტორიაში (`sudo`-ს ქვეშ ეს `sudo`-ს გამომძახებელი მომხმარებელია და არა root: მაგალითად, `/home/ivan/.aihummer`). ფაილები ამ მომხმარებელს ეკუთვნის და სერვისები მისი სახელით მუშაობენ: ```text ~/.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 ერთეულის ფაილები, რომლებიც გენერირდება `systemd/`-ის ქვეშ, **სიმბოლურადაა დაკავშირებული `/etc/systemd/system/`-ში**, ასე რომ ისინი იმართება ჩვეულებრივი `systemctl` ბრძანებებით. ## ინსტალაცია root-ის გარეშე (rootless) `sudo`/root უფლებები სავალდებულო არ არის. თუ ინსტალაციის ბრძანებას გაუშვებთ **sudo-ს გარეშე**, ინსტალერი გადადის rootless რეჟიმში: ერთეულები რეგისტრირდება მომხმარებლის scope-ში `systemd --user` (ფაილები `~/.config/systemd/user`-ში), CLI `aihummer` და 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 მშობლიურად, კითხვის გარეშე | | `--external-search=URL` / `--external-browser=URL` | გამოიყენე არსებული სერვისი ამ URL-ზე, ინსტალაციის ნაცვლად | | `--no-search` / `--no-browser` | გამოტოვე ეს sidecar | | `--with-embedder` | დააინსტალირე სემანტიკური ემბედერი (**opt-in**: მოაქვს PyTorch — ასეულობით МБ) | tty-სა და ალმის გარეშე search/browser გამოიტოვება. ემბედერი ასევე ირთვება ცვლადით `AIHUMMER_WITH_EMBEDDER=1`; მის გარეშე მეხსიერება მუშაობს ლექსიკურ fallback ძებნაზე. ინტერფეისის ენას ადგენს `AIHUMMER_LANG=ru|en` (სხვაგვარად ინსტალერი tty-ზე გკითხავთ). PostgreSQL-ის დაკავშირება მოთხოვნილია tty-ზე; არაინტერაქტიული ინსტალაციისთვის წინასწარ დააყენეთ `AIHUMMER_DATABASE_URL`. tty-ზე ინსტალერი ასევე გთავაზობთ სარეზერვო ასლიდან აღდგენას. ```bash # Install the gateway with native search and embedder, no browser curl -fsSL "<ინსტალაციის პერსონალური ბმული>" | sudo bash -s -- \ --with-search --with-embedder --no-browser ``` რადგან sidecar-ებს URL-ით აღწევენ, შეგიძლიათ მშობლიური და გარე თავისუფლად შეურიოთ და რამდენიმე gateway მიამართოთ ერთ გაზიარებულ sidecar-ზე. ## გამოშვების არხები AiHummer გამოდის ოთხ არხზე: **stable**, **alfa**, **beta** და **dev**. პირადი კაბინეტის პერსონალური ბმული აყენებს **stable** არხს — ეს არის შტატური გზა ყველა მომხმარებლისთვის. | არხი | წვდომა | ობფუსცირებული | |---|---|---| | stable | პერსონალური ბმული პირადი კაბინეტიდან | — | | alfa | გაიცემა ვენდორის მიერ (ტესტირების პროგრამები) | დიახ | | beta | გაიცემა ვენდორის მიერ (ტესტირების პროგრამები) | დიახ | | dev | გაიცემა ვენდორის მიერ | არა (ობფუსკაციის გარეშე) | alfa/beta/dev არხები გასაღებით-ფილტრულია და განკუთვნილია ადრეული ტესტირების პროგრამების მონაწილეთათვის — მათზე წვდომას ვენდორი ინდივიდუალურად გასცემს. ყველა არხის არტეფაქტები ვრცელდება როგორც თითო-არქიტექტურის tarball, თანმხლები `.sha256` checksum-ითა და cosign `.sig` ხელმოწერით — ორივე მოწმდება ინსტალაციისას და ყოველი განახლებისას. ## ინსტალაციის გადამოწმება მას შემდეგ, რაც ინსტალერი დასრულდება, შეამოწმეთ სერვისი და მზადყოფნის endpoint: ```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`-ს სწრაფი ჯანმრთელობის მიმოხილვისთვის. ## სად შემდეგ - პირველი გაშვება: იხ. [პირველი შესვლა](/ka/v1.0/getting-started/first-login) ადმინისტრატორის საწყისი პაროლის ფაილიდან `~/.aihummer/etc/initial-admin-password.txt` მისაღებად. - გასაწყობად განთავსება: წაიკითხეთ [კონფიგურაცია](/ka/v1.0/getting-started/configuration). - გსურთ პირველი გაშვება ნაბიჯ-ნაბიჯ გაიაროთ? გამოიყენეთ [სწრაფი დაწყება](/ka/v1.0/getting-started/quickstart).