CLI-ის სახელმძღვანელო

sudo aihummer up
aihummer status

# Only check whether a newer release exists
aihummer update --check

# Apply the update
sudo aihummer update

sudo aihummer restart
aihummer logs                 # the gateway unit's journal (default; follows)
aihummer logs --no-follow     # print the tail of the journal and exit
aihummer logs aihummer-stt    # another systemd unit's journal
sudo aihummer stop

aihummer doctor

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql

sudo aihummer set-password --login admin

aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings get AIHUMMER_STT_URL
aihummer settings list

aihummer license keygen                # generate a signing key
aihummer license sign                  # sign a license
aihummer license show <token>          # decode + verify a token

aihummer loadtest

aihummer plugin init <kind>            # scaffold a manifest (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # validate a manifest against the contract
aihummer plugin keygen                 # ed25519 author key (.key + .pub)
aihummer plugin package ./my-plugin    # build a tarball + .sha256
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Publish privately to your instance (public publishing is done in the portal — "My plugins")
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz

ეს `aihummer` კომანდის ხაზის ინსტრუმენტი მართავს ინსტალაციას ჰოსტზე: ის იწყებს და აჩქარებს გეითვეის (ინსტალაცია ხდება თქვენი ანგარიშის პორტალიდან პირადი ინსტალაციის ბმულის საშუალებით), აკონტროლებს გეითვეის systemd სერვისს, ასრულებს დიაგნოსტიკა, ამუშავებს სარეზერვო კოპიებს, კითხულობს და წერს მართვის ბარათის პარამეტრებს, ასევე აწერს ლიცენზიებს. ეს გვერდი ჩამოთვლის ყველა ბრძანებას. ## კომანდები | კომანდა | ეს რას აკეთებს | |---|---| | `up` / `install` | გააქტიურეთ systemd სერვისი გეითვეისათვის (`systemctl start`). ის არაფერს აწესებს — ინსტალაცია შესრულდება თქვენს პირად ბმულზე არსებული ინსტალაციის სკრიპტის საშუალებით. | | `update [--check]` | განაახლეთ ბოლო ვერსიამდე (შემოწმეთ ხელმოწერა + ჩაანაცვლეთ ბინარული ფაილი + გადატვირთეთ); `--check` უბრალოდ იტყობინება, ხელმისაწვდომია თუ არა განახლება. | | `restart` | გააკეთეთ გეითვეის სერვისის გადატვირთვა (`systemctl restart`). | | `stop` | შეაჩერეთ გეითვეის სერვისი (`systemctl stop`). | | `logs [unit] [--no-follow]` | დაეძიოთ ერთი systemd ერთეულის ჟურნალი (`journalctl -u`); ნაგულისხმევად — გეითვეის ერთეული. `--no-follow` ბეჭდავს ჟურნალის ბოლოს და გამოდის; მის გარეშე ბრძანება თვალყურის დევნებას აგრძელებს. | | `status` | ინსტალაციის მიმოხილვა, სერვისების მდგომარეობა და კარიბჭის მზადყოფნა (`/readyz`). სექცია **კომპონენტები** აჩვენებს არასავალდებულო საიდკარ-ერთეულების მდგომარეობას (ძიება, ბრაუზერი, მეტყველება ტექსტში, ტექსტი მეტყველებაში, ვიდეო); როცა `systemctl` მიუწვდომელია, ის პატიოსნად ამბობს, რომ მდგომარეობა უცნობია, და არა „არ არის დაყენებული“. | | `doctor` | დიაგნოსტიკა სამი ვერდიქტით: ყველაფერი კარგადაა, მუშაობს გაფრთხილებებით (N), ან ნაპოვნია პრობლემები. Node.js-ისა და ფლოტში რეგისტრაციის მასალის შემოწმებები გაფრთხილებებია და არა ჩავარდნები. | | `backup [dir]` | `pg_dump` PostgreSQL-ის მდგომარეობა ფაილში; ნაგულისხმევად გამოიყენება დირექტორია, თუ ის არ არის მითითებული. | | `restore <file>` | თვითდე PostgreSQL-ის აღდგენა დამპ-ფაილიდან, რომელიც შეიქმნა `backup`. | | `uninstall [flags]` | აიღეთ ინსტალაცია (იხილეთ ქვემოთ ფლებები). საჭიროებს root — გაშვით ეს `sudo`. | | `set-password` / `admin-password` | დააყენეთ/შექმენით ლოკალური ადმინისტრატორის პაროლი (`[--login admin] [--password X]`). | | `settings {set\|get\|list}` | მართვის გეგმის პარამეტრების წაკითხვა/ჩაწერა მონაცემთა ბაზაში — ასე ხდება პარამეტრების კატალოგის ელემენტების ჩამორთმევა კომანდის სტრიქონიდან `gateway.env`. | | `license {keygen\|sign\|show <token>}` | ლიცენზიების მართვა: გენერირება გასაღები, ხელი მოაწერო, დეკოდირება + გადამოწმება მოცემული ტოკენის. | | `loadtest` | გაატარეთ გატარფვის ტესტირება გეიტვეიზე. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | SDK პლაგინი: ჩარჩოს შექმნა, შემოწმება, გასაღებები, პაკეტირება, ხელმოწერა და გამოქვეყნება. | | `version` | აჩვენეთ ვერსია. | | `help` | დაჩვენება დახმარება. | ### `uninstall` დროშები | ფარიოლი | ეფექტი | |---|---| | `--purge` | ასევე წაშალეთ მონაცემები (სრული წაშლა). | | `--yes` | დააზარალონ დადასტურების მოთხოვნა. | | `--no-backup` | არ გააკეთოთ სარეზერვო კოპია წაშემდეგ. | | `--backup-dir <dir>` | შეინახეთ სარეზერვო ასლი ამ კატალოგში წაშლის წინ. | ## გამოყენების მაგალითები ### გაყვანაა და გაშვება ინსტალაცია ხდება თქვენი ანგარიშიდან ინსტალაციის პირადი ბმულის საშუალებით (იხ. [დაყენება](/ka/v1.0/getting-started/installation)); ამის შემდეგ იწყება CLI და ამოწმებს სერვისს: ```bash sudo aihummer up aihummer status ``` ### განახლება ```bash # Only check whether a newer release exists aihummer update --check # Apply the update sudo aihummer update ``` ### სერვისის მართვა და ჟურნალები კომანდები მოქმედებენ ერთიან სისტემურ ერთეულზე Gateway systemd (`AIHUMMER_SERVICE`, ნაგულისხმევი `aihummer-gateway`); `logs` იღებს ნებისმიერ systemd ერთეულის სახელს. ```bash sudo aihummer restart aihummer logs # the gateway unit's journal (default; follows) aihummer logs --no-follow # print the tail of the journal and exit aihummer logs aihummer-stt # another systemd unit's journal sudo aihummer stop ``` ### დიაგნოსტიკა ```bash aihummer doctor ``` ### სარეზერვო კოპირება და აღდგენა `backup` მართავს `pg_dump` PostgreSQL-ს გამობერილების მდგომარეობის ფაილში; `restore` მიიღეთ ეს დამლური ფაილი. ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/aihummer-2026-07-05.sql ``` > [!TIP] > Postgres არის სიწმინდეების წყარო, მაგრამ თქვენი `AIHUMMER_MASTER_KEY` და წვეთი > კატალოგი უნდა გაიწეროს ცალ-ცალკე — უპაროლოს, დაშიფრული > საიდუმლოებების აღდგენა შეუძლებელია. ### გაადგინეთ ადმინისტრატორის პაროლი კომანდა იღებს `[--login admin] [--password X]` და მოთხოვნილებები `AIHUMMER_DATABASE_URL` — ჩვეულებრივ ირჩევა `gateway.env` ინსტალაციის გამოყენებით ან მომხმარებლის სახელით დაწყებისას `sudo`. ```bash sudo aihummer set-password --login admin ``` ### მართვის თავსის პარამეტრები `settings` წაიკითხავს და ჩაწერს დირექტორიის პარამეტრებს Settings პირდაპირ მონაცემთა ბაზაში — იგივე შენახვის ადგილი, რომელსაც შეიცავენ ადმინისტრატორის ვებინტერფეისი (მართვა → პარამეტრები). აი როგორ ითვლება დირექტორიის პარამეტრები CLI-ის მეშვეობით: `gateway.env` მათი მნიშვნელობები იგნორირდება. ```bash aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001 aihummer settings get AIHUMMER_STT_URL aihummer settings list ``` `settings list` აჩვენებს მხოლოდ კატალოგის კლავიშებს, რომლებიც მოსახიბლველისთვის ჩანს (სისტემური და შიდა კლავიშები დამალულია); თითოეული კლავიში აღნიშნულია მისი წყაროდ `[db]` თქვენ მიერ განსაზღვრული მნიშვნელობებისთვის, `[unset]` სამედიცინო შემთხვევაში კატალოგის ნაგულისხმევი პარამეტრით. ### ლიცენზიები `license show` მობაძვის `<token>` არგუმენტი და `AIHUMMER_LICENSE_PUBKEY` მცვლადი: ის დეკოდირებს და ამოწმებს **მოცემული** ტოკენი — ეს არ ასახავს მიმდინარე ინსტანსის ლიცენზიას. ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show <token> # decode + verify a token ``` ### საწვრთნელი ტესტირება ```bash aihummer loadtest ``` ### პლაგინები ```bash aihummer plugin init <kind> # scaffold a manifest (connector|service|openapi|mcp) aihummer plugin validate manifest.json # validate a manifest against the contract aihummer plugin keygen # ed25519 author key (.key + .pub) aihummer plugin package ./my-plugin # build a tarball + .sha256 aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz # Publish privately to your instance (public publishing is done in the portal — "My plugins") aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz ``` სრული SDK-ისთვის და საერთო კატალოგში პუბლიკაციისთვის პორტალზე («ჩემი პლაგინები») იხ. [პლაგინების განვითარების ნაკრები](/ka/v1.0/marketplace/sdk) და [პლაგინის გამოქვეყნება](/ka/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` უნდა ჰქონდეს root–ის უფლებები: გაშვება `sudo aihummer uninstall`. და > `sudo aihummer uninstall --purge --yes` ამოჰყავს მონაცემები და გამოტოვებს > დადასტურების შეტყობინება — ჯერ შეამოწმეთ, გაქვთ თუ არა დადასტურებული სარეზერვო კოპია. ## გარემო ცვლადები `aihummer` ინსტრუმენტი თვითონ კითხულობს: | ცვლადი | მიზანი | |---|---| | `AIHUMMER_SERVICE` | შლუგის systemd ერთეულის სახელი (ნაგულისხმევი) `aihummer-gateway`) — მიზანი `up`/`restart`/`stop`/`logs`. | | `AIHUMMER_GATEWAY_URL` | გეიტვეის URL `status`/`doctor`/`loadtest` (ნაგულისხმევი `http://127.0.0.1:8780`). | | `AIHUMMER_DATABASE_URL` | Postgres DSN — საჭიროა `backup`/`restore`/`set-password`/`settings`. | | `AIHUMMER_LANG` | CLI-ის გამონატანისა და დახმარების ენა: `ru` (ნაგულისხმევი) ან `en`. | ბოლო უმეტესობას გუნდისთვის root სჭირდება (`systemctl`) — წაიქაჩეთ ისინი `sudo`. ## სად შემდეგ? - გაააქტიურეთ ინსტანცია: [გარემოს ცვლადები](/ka/v1.0/reference/env-vars). - განსაზღვრეთ, რა ინსტრუმენტებით შეუძლია აგენტს ისარგებლოს: [ობიექტების კატალოგი](/ka/v1.0/reference/tools-catalog).