სისტემური მოთხოვნები — AiHummer დოკუმენტაცია

AiHummer — ეს არის პროდუქტი, განკუთვნილია ჰოსტისთვის: ის ირთვება როგორც გამოსაცემი tar-არქივი systemd-ის ქვეშ, ამიტომ მოთხოვნები განზრახ მინიმალურია. ერთადერთი მკაცრი დამოკიდებულება არის ჰოსტი Linux-ით და PostgreSQL-ით. ყველაფერი დანარჩენი — საიდკარები, ნამდვილად მოდელი, ვექტორული საცავი — აუცილებელი არაა და შემდგომში ადმინისტრაციული ინტერფეისის საშუალებით შეიძლება დაემატოს.

[!NOTE] AiHummer ეს არის ჰოსტში, არა Docker-ში. ის იშლება როგორც tar-არქივი, რომელიც მუშაობს systemd-დან ~/.aihummer (მომხმარებლის სახლის კატალოგი, რომელმაც აინსტალირებელი). თქვენ არ გჭირდებათ კონტეინერის runtime, Kubernetes ან სხვა რამ ორკესტრატორი.

ოპერაციული სისტემა

AiHummer მუშაობს მხოლოდ Linux-ისთვის. Windows-ისა და macOS-ისთვის სერვერის კომპილაცია არ არსებობს — სარკმელი და მისი საიდკარები შეფუთულია Linux-ის არტეფაქტების სახით თითოეული არქიტექტურისთვის და განთავსდება systemd-ის საშუალებით. (კლიენტი — ეს არის ცალკეული მობილური და სამაგიდო აპლიკაცია; ეს არხი, არა სერვერი.)

თანამედროვე 64-ბიტიანი Linux დისტრიბუტივი systemd.
x86_64 (amd64) ან arm64 — გამშვები აგროვებს შესაბამის პაკეტს ყოველი არქიტექტურისთვის.
sudo/root წვდომა არის არ არის მკაცრად აუცილებელი: წესიერი ინსტალაცია მიმდინარეობს sudo, მაგრამ ინსტალატორის გაშვება root-ის გარეშე აყენებს AiHummer-ს root-ის უფლებების გარეშე რეჟიმი ქვემოთ systemd --user — ნახვა დაყენება.

მონაცემთა ბაზა

PostgreSQL არის მხოლოდ მკვეთრი დამოკიდებულება და მთელი მდგომარეობის სიმართლის ერთადერთი წყარო. pgcrypto გაფართოება არის საჭიროა — ის მხარს უჭერს დაშიფრული მონაცემთა საცავს. ბაზის გარეშე, გეითი იწყება გამარტივებულ მხოლოდ ჯანმრთელობისთვის რეჟიმში და არაფერს სასარგებლოს არ აწვდის.

[!IMPORTANT] ჩართვა pgcrypto საშლელ ბაზაში, პირველ გაშვებამდე:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

გეითვეი უკავშირდება DSN-ის მეშვეობით AIHUMMER_DATABASE_URL. მრავალხრიანი იზოლაციისთვის ასევე შეგიძლიათ მიუთითოთ AIHUMMER_DB_APP_URL შეზღუდულ aihummer_app როლი Postgre Row-Level Security-ის ჩართვისთვის; ადგილობრივი ინსტალაციები ამას ავტომატურად სწორად ადგენენ. მონაცემთა ბაზის მიგრაციები უსაფრთხოა განახლებებისთვის და ავტომატურად ტარდება მფლობელის პულის ქვეშ ტრანზაქციის ბლოკირებით.

კომპიუტერული უზრუნველყოფა

ეს ციფრები არის მიმართულების მაჩვენებელი გეითვეის და PostgreSQL-ის ერთავე ჰოსტზე განლაგებისთვის. საიდკარები (STT/TTS, ბრაუზერი, ვექტორული საცავი) უტოვებენ საკუთარ კვალს და ჩვეულებრივ განლაგდებიან იმავე ჰოსტზე მხოლოდ მცირეთვის გაშლის.

პროფილი	ცპუ	RAM	დისკი	შენიშვნები
მინიმუმი (შეფასება)	2 ვირტუალური პროცესორი (vCPU)	2 გბ	10 გბ	გეიტვეი + Postgres, მოდელის მაკეტი, გარეშე საიდკარების
რეკომენდირებულია	4 ვირტუალური პროცესორი (vCPU)	8 გბ	40 გბ SSD	გეითვეი + Postgres + ორი საიდკარი
ხმოვანი / ლოკალური მოდელები	8+ vCPU (GPU სურვილის მიხედვით)	16+ გბ	SSD 80+ გბ	STT/TTS, ემბედერი, ადგილობრივი საბოლოო წერტილი LLM

დისკის გამოყენება იზრდება საუბრის ისტორიის, მრავალმედია ფაილების კატალოგის მიხედვით (AIHUMMER_BLOB_DIR), ცოდნის შთანთქმა და აუდიტის შენახვა. გეგმეთ PostgreSQL–ის სარეზერვო ასლების შექმნა (pg_dump + WAL/PITR) შესაბამისად.

საიდკარები (თვითნებურად)

ბავშვთა ვაზნები გაყოფილი HTTP სერვისები, თითოეული თავისი საკუთარი unit systemd-ის მიხედვით. გეითვეი მიმართავს მათ URL-ებით, ამიტომ sidecar-ს შეუძლია იმუშაოს იმავე ჰოსტზე, სხვა ჰოსტზე ან შეგიძლიათ მიუთითოთ არსებული ინსტანციაზე. ყველა მათგანი უფასო/ლოკალურია და არასოდეს არის საჭირო ძირითად გამოყენებაში გაშლა.

საიქარი	სტანდარტული პორტი	ჩართულია
STT (faster-whisper)	8001	სიტყვები ტექსტში სასაუბრო მოსახვევებისთვის
TTS (edge-tts)	8002	ტექსტის ხმად გარდაქმნა ზეპირი პასუხებისთვის
ვიდეო (ffmpeg)	8005	ვიდეოს გაგება
SearXNG	8888	ეს `web_search` ინსტრუმენტი
ქრომი/CDP	9222	ეს `browser` / `computer` ინსტრუმენტები

STT, TTS, ვიდეო, ვებ-ძიება (SearXNG) და ბრაუზერი (CloakBrowser) — ყველა მათგანს ინსტალატორი ყუთიდანვე აყენებს. ძიებისა და ბრაუზერის პაკეტები შედის ხელმოწერილ საინსტალაციო ბანდლში და ინსტალირდება ოფლაინ: გამორთეთ ისინი --no-search / --no-browser დროშებით, ან ლოკალური ინსტალაციის ნაცვლად მიაერთეთ უკვე გაშვებული ინსტანსი --external-search=URL / --external-browser=URL საშუალებით. ხმოვანი საიდკარები გამოტოვეთ AIHUMMER_SKIP_* ცვლადებით. სემანტიკური ჩასამტვრევი — სურვილისამებრ (--with-embedder): ის აყენებს PyTorch-ს (ასეულობით MB), და მის გარეშე მეხსიერება ბრუნდება ლექსიკალურ ძიებაზე. იხილეთ დაყენება.

[!NOTE] Node.js (ვერსია 20 ან უფრო ახალი) ასევე შედის საინსტალაციო ბანდლში და ინსტალირდება ოფლაინ, ამიტომ Node.js-ის პლაგინები — AiHummer-ის აპლიკაცია, pocket-agent და არხების კონექტორები — მუშაობენ ყუთიდანვე იმ დისტრიბუტივებზეც, რომელთა საკუთარი Node.js ძალიან ძველია.

LLM-მომწოდებლები

AiHummer არასდროს მოითხოვს ფასიან მოდელს. ის მუშაობს პირდაპირ კარადიდან თავისუფალ/ლოკალურ მოდელებზე და Codex/ChatGPT-გამოწერის ტრანსპორტიორთან ერთად; BYOK გასაღებები თითოეული დაინტერესებული მხარისთვის მკაცრად არაა აუცილებელი.

მხარდაჭერილი პროვაიდერები:

ანტროპიკური
OpenAI.
თითოეული საბოლოო წერტილი OpenAI API-ის სტანდარტში — მოდელების ლოკალური სერვერები, OpenRouter, ან მაგალითად, OpenAI-თან თავსებადი Gemini-ის საბოლოო წერტილი.
Codex / ChatGPT გამოწერის ტრანსპორტი — მართავს მოდელს ChatGPT-ის საშუალებით გამოწერა, არა გადახდილი API-კლავი.

[!TIP] თუ თქვენ გაუშვებთ გასასვლელს მოდელის მიჯაჭვის გარეშე (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), პასუხები მოდის დეტერმინირებული გაწვალება თქვენ რომ შეძლოთ არხების შემოწმება და მარშრუტიზაცია რეალურ მოდელთან დაკავშირებამდე.

[!NOTE] AiHummer გამოავლენს მხოლოდ OpenAI-სთან თავსებად პროდუქტებს POST /v1/chat/completions საბოლოო წერტილი. არის არა /v1/models ან /v1/embeddings HTTP-ენდპოინტი, და თვალსაჩინოება — ეს არის OTLP-push (Prometheus-ის გარეშე) /metrics).

სად შემდეგ?

მზად ხართ გაშვებისათვის? გადადით დაყენება.
გინდათ პირველი გაშვება გაიაროთ ნაბიჯ-ნაბიჯ? ნახეთ სწრაფი დაწყება.
გინდა თავიდან გონებრივი მოდელი? წაიკითხე შესავალი.