სისტემური მოთხოვნები
AiHummer არის ჰოსტ-მშობლიური პროდუქტი: ის მუშაობს როგორც გამოშვების tarball systemd-ის ქვეშ, ასე რომ მოთხოვნები შეგნებულად მცირეა. ერთადერთი მკაცრი დამოკიდებულება არის Linux ჰოსტი PostgreSQL-ით. ყველაფერი დანარჩენი — sidecar-ები, რეალური მოდელი, ვექტორული საცავი — არასავალდებულოა და შეიძლება მოგვიანებით დაემატოს ადმინ UI-დან.
[!NOTE] AiHummer არის ჰოსტ-მშობლიური, არა Docker. ის იშლება როგორც tarball, რომელიც systemd-ის ქვეშ მუშაობს
/home/.aihummer-დან. არ გჭირდებათ კონტეინერის გარემო, Kubernetes ან რაიმე ორკესტრატორი.
ოპერაციული სისტემა
AiHummer მუშაობს მხოლოდ Linux-ზე. არ არსებობს Windows-ის ან macOS-ის სერვერის ბილდი — gateway და მისი sidecar-ები შეფუთულია როგორც თითო-არქიტექტურის Linux არტეფაქტები და იშლება systemd-ით. (კლიენტი ცალკე მობილური და დესკტოპის აპლიკაციაა; ეს არის არხი, არა სერვერი.)
- თანამედროვე 64-ბიტიანი Linux დისტრიბუცია
systemd-ით. x86_64(amd64) ანarm64— ინსტალერი იღებს შესაბამის თითო-არქიტექტურის ნაკრებს.sudo/root წვდომა ინსტალაციის ფესვის ჩასაწერად და systemd ერთეულების დასარეგისტრირებლად.
მონაცემთა ბაზა
PostgreSQL არის ერთადერთი მკაცრი დამოკიდებულება და ერთადერთი ჭეშმარიტების
წყარო ყველა მდგომარეობისთვის. pgcrypto გაფართოება საჭიროა — ის უზრუნველყოფს
დაშიფრულ რწმუნებების ვალტს. მონაცემთა ბაზის გარეშე, gateway ეშვება შემცირებულ
მხოლოდ-ჯანმრთელობის რეჟიმში და არაფერ სასარგებლოს არ მიაწვდის.
[!IMPORTANT] ჩართეთ
pgcryptoსამიზნე მონაცემთა ბაზაში პირველ გაშვებამდე:CREATE EXTENSION IF NOT EXISTS pgcrypto;
gateway უკავშირდება DSN-ის გავლით AIHUMMER_DATABASE_URL-ში. მრავალმოიჯარე
იზოლაციისთვის შეგიძლიათ დამატებით მიამართოთ AIHUMMER_DB_APP_URL შეზღუდულ
aihummer_app როლზე, რომ ააქტიუროთ Postgres Row-Level Security; ლოკალური
ინსტალაციები ამას ავტომატურად აყენებენ. მონაცემთა ბაზის მიგრაციები
წინ-უსაფრთხოა და გამოიყენება ავტომატურად საკონსულტაციო ბლოკის ქვეშ მფლობელის
პულზე.
აპარატურა
ეს ციფრები ერთ-ჰოსტიანი განთავსების მითითებაა gateway-ისა და PostgreSQL-ისთვის. sidecar-ები (STT/TTS, ბრაუზერი, ვექტორული საცავი) ამატებენ საკუთარ კვალს და ჩვეულებრივ ერთსა და იმავე ჰოსტზე თავსდებიან მხოლოდ მცირე განთავსებებისთვის.
| პროფილი | CPU | RAM | დისკი | შენიშვნები |
|---|---|---|---|---|
| მინიმუმი (შეფასება) | 2 vCPU | 2 GB | 10 GB | Gateway + Postgres, mock მოდელი, sidecar-ების გარეშე |
| რეკომენდებული | 4 vCPU | 8 GB | 40 GB SSD | Gateway + Postgres + რამდენიმე sidecar |
| ხმა / ლოკალური მოდელები | 8+ vCPU (GPU არასავალდებულო) | 16+ GB | 80+ GB SSD | STT/TTS, ემბედერი, ლოკალური LLM endpoint |
დისკის გამოყენება იზრდება საუბრების ისტორიასთან, მედია blob დირექტორიასთან
(AIHUMMER_BLOB_DIR), ცოდნის მიღებასა და აუდიტის შენახვასთან ერთად. დაგეგმეთ
PostgreSQL-ის სარეზერვო ასლები (pg_dump + WAL/PITR) შესაბამისად.
sidecar-ები (არასავალდებულო)
sidecar-ები არის ცალკე HTTP სერვისები, თითოეული საკუთარი systemd ერთეულის ქვეშ. gateway აღწევს მათ URL-ით, ასე რომ sidecar-ს შეუძლია იმუშაოს იმავე ჰოსტზე, სხვა ჰოსტზე, ან შეგიძლიათ მიამართოთ არსებულ ინსტანციაზე. ისინი ყველა უფასო/ლოკალურია და არასოდესაა საჭირო ძირითადი განთავსებისთვის.
| Sidecar | ნაგულისხმევი პორტი | ჩართავს |
|---|---|---|
| STT (faster-whisper) | 8001 | მეტყველება-ტექსტად ხმოვანი სვლებისთვის |
| TTS (edge-tts) | 8002 | ტექსტი-მეტყველებად ხმოვანი სვლებისთვის |
| Diarize (pyannote) | 8003 | მოლაპარაკის დიარიზაცია |
| Voiceclone (OpenVoice V2) | 8004 | ხმის კლონირება |
| Video (ffmpeg) | 8005 | ვიდეოს გაგება |
| SearXNG | 8888 | web_search ხელსაწყო |
| Chrome/CDP | 9222 | browser / computer ხელსაწყოები |
ინსტალერს შეუძლია უზრუნველყოს sidecar-ები მშობლიურად, ან შეგიძლიათ მიამაგროთ არსებული URL-ით — იხ. ინსტალაცია.
LLM პროვაიდერები
AiHummer არასოდეს მოითხოვს ფასიან მოდელს. ის მუშაობს ყუთიდან უფასო/ლოკალურ მოდელებსა და Codex/ChatGPT-ხელმოწერის ტრანსპორტზე; თითო-მოიჯარის BYOK გასაღებები მკაცრად არასავალდებულოა.
მხარდაჭერილი პროვაიდერები:
- Anthropic.
- OpenAI.
- ნებისმიერი OpenAI-API-სტანდარტის endpoint — ლოკალური მოდელის სერვერები, OpenRouter, ან Gemini-ის OpenAI-თავსებადი endpoint, მაგალითად.
- Codex / ChatGPT-ხელმოწერის ტრანსპორტი — მართეთ მოდელი ChatGPT ხელმოწერით, ნაცვლად ანგარიშფაქტურირებული API გასაღებისა.
[!TIP] თუ gateway-ს გაუშვებთ მოდელის დაკავშირების გარეშე (
AIHUMMER_LLM_PROVIDER/AIHUMMER_LLM_MODEL/AIHUMMER_LLM_GATEWAY_URL), პასუხები მოდის დეტერმინისტული mock-დან, ასე რომ შეგიძლიათ შეამოწმოთ არხები და მარშრუტიზაცია რეალური მოდელის დაკავშირებამდე.
[!NOTE] AiHummer გვთავაზობს მხოლოდ OpenAI-თავსებად
POST /v1/chat/completionsendpoint-ს. არ არსებობს/v1/modelsან/v1/embeddingsHTTP endpoint, და დაკვირვებადობა არის OTLP-push (Prometheus/metrics-ის გარეშე).
სად შემდეგ
- მზად ხართ განთავსებისთვის? გადადით ინსტალაციაზე.
- გსურთ პირველი გაშვება ნაბიჯ-ნაბიჯ გაიაროთ? იხ. სწრაფი დაწყება.
- გსურთ ჯერ მენტალური მოდელი? წაიკითხეთ შესავალი.