Sistem Tələbləri — AiHummer Sənədlər

AiHummer hoz-yerli məhsuldur: o, systemd altında release tarball kimi işləyir, buna görə tələblər bilərəkdən kiçikdir. Yeganə ciddi asılılıq PostgreSQL ilə Linux hostudur. Qalan hər şey — sidecar-lar, real model, vektor saxlama — opsionaldır və admin UI-dan sonra əlavə edilə bilər.

[!NOTE] AiHummer-dir host-təhlükəsiz, Docker deyil. O, altında işləyən bir tarbol kimi yerləşdirilir systemd-dən ~/.aihummer (bu əmri işlədən istifadəçinin ev kataloqu quraşdırıcı). Sizə konteyner iş vaxtı, Kubernetes və ya hər hansı bir şey lazım deyil orxestrator

Əməliyyat sistemi

AiHummer işləyir Yalnız Linux. Heç bir Windows və ya macOS server versiyası yoxdur — şlüz və onun yan prosessləri arxitektura üzrə Linux paketləri kimi çatdırılır və systemd ilə yerləşdirilir. (Müştəri isə ayrıca mobil və masaüstü tətbiqdir; bu server deyil, kanaldır.)

Müasir 64-bitlik Linux paylaması ilə systemd.
x86_64 (amd64) və ya arm64 — quraşdırıcı uyğun arxitektura paketi çəkir.
sudo/root girişidir mütləq tələb olunmur: normal quraşdırma vasitəsilə işləyir sudo, amma quraşdırmanı root olmadan işə salmaq AiHummer-i root olmadan quraşdırır rejim altında systemd --user — görmək Quraşdırma.

Verilənlər bazası

PostgreSQL biridir yalnız sərt asılılıq və bütün dövlətlər üçün yeganə həqiqət mənbəyi. pgcrypto uzantıdır tələb olunan — bu şifrələnmiş etimadnamə anbarını dəstəkləyir. Verilənlər bazası olmadan, giriş qapısı azaldılmış yalnız sağlamlıq rejimində başlayır və heç bir faydalı şey göstərmir.

[!IMPORTANT] Aktiv et pgcrypto ilk işə salmadan əvvəl hədəf verilənlər bazasında:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Şlüz DSN vasitəsilə qoşulur AIHUMMER_DATABASE_URL. Çoxistifadəçi təcrid üçün əlavə olaraq göstərə bilərsiniz AIHUMMER_DB_APP_URL məhdud bir yerdə aihummer_app Postgres Satır-Səviyyəli Təhlükəsizliyi aktivləşdirmək üçün rol; lokal quraşdırmalar bunu avtomatik olaraq qurur. Verilənlər bazası miqrasiyaları irəliyə təhlükəsizdir və sahib hovuzunda məsləhətçi kilid altında avtomatik tətbiq olunur.

Avadanlıq

Bu rəqəmlər qapı (gateway) və PostgreSQL-in tək server üzərində yerləşdirilməsi üçün təlimatdır. Sidecar-lar (STT/TTS, brauzer, vektor yaddaşı) öz resurslarını əlavə edir və adətən yalnız kiçik yerləşdirmələr üçün eyni serverdə yerləşdirilir.

Profil	CPU	RAM	Disk	Qeydlər
Minimum (qiymətləndirmə)	2 vCPU	2 GB	10 QB	Gateway + Postgres, saxta model, heç bir yan maşın
Tövsiyə olunur	4 vCPU	8 GB	40 GB SSD	Gateway + Postgres + bir neçə sidecar
Səs / lokal modellər	8+ vCPU (GPU isteğe bağlı)	16+ GB	80+ GB SSD	STT/TTS, embedder, lokal LLM son nöqtəsi

Disk istifadəsi söhbət tarixçəsi ilə artır, media blob qovluğu (AIHUMMER_BLOB_DIR), bilik əldə etmə və audit saxlanması. PostgreSQL ehtiyat nüsxələrini (pg_dump + WAL/PITR) uyğun olaraq planlayın.

Yan arabalar (isteğe bağlı)

Yan arabalar ayrı HTTP xidmətləri, hər biri öz systemd vahidi altında. Qapı onlara URL vasitəsilə çatır, beləliklə, sidecar eyni ev sahibində, digər bir ev sahibində işləyə bilər və ya mövcud bir nümunəni göstərə bilərsiniz. Onların hamısı pulsuz/lokal və əsas yerləşdirmə üçün heç vaxt tələb olunmur.

Yan arabası	Standart port	İmkan verir
STT (daha sürətli-pıçılda)	8001	Səs çevrilməsi mətinə səs üçün
TTS (edge-tts)	8002	Səs növbələri üçün mətn-səsləndirmə
Video (ffmpeg)	8005	Video başa düşmə
SearXNG	8888	O `web_search` alət
Chrome/CDP	9222	O `browser` / `computer` alətlər

STT, TTS, video, veb axtarış (SearXNG) və brauzer (CloakBrowser) — hamısı quraşdırıcı tərəfindən qutudan çıxan kimi quraşdırılır. Axtarış və brauzer yükləri imzalanmış quraşdırıcı bandlının içində gəlir və oflayn quraşdırılır: onları --no-search / --no-browser ilə söndürün, ya da yerli quraşdırma əvəzinə artıq işlətdiyiniz nümunəni --external-search=URL / --external-browser=URL ilə qoşun. Səs yan maşınlarını AIHUMMER_SKIP_* dəyişənləri ilə atlaya bilərsiniz. Semantik yerləşdirici isə qoşulmaq (--with-embedder): bu PyTorch-u çəkir (yüzlərlə MB), və olmadan yaddaş leksik axtarışa qayıdır. Bax Quraşdırma.

[!NOTE] Node.js (20 və ya daha yeni versiya) də quraşdırıcı bandlının içində gəlir və oflayn quraşdırılır, buna görə Node.js plaqinləri — AiHummer tətbiqi, pocket-agent və kanal konnektorları — öz Node.js-i çox köhnə olan distributivlərdə belə qutudan çıxan kimi işləyir.

LLM təminatçıları

AiHummer heç vaxt ödənişli model tələb etmir. O, pulsuz/lokal modellərdə və Codex/ChatGPT abunə nəqli vasitəsilə qutudan çıxan kimi işləyir; hər bir istifadəçi üçün BYOK açarları tamamilə könüllüdür.

Dəstəklənən provayderlər:

Antropik.
OpenAI.
Hər hansı OpenAI-API-standart son nöqtəsi — yerli model serverləri, OpenRouter, və ya Məsələn, Gemini-nin OpenAI-ə uyğun son nöqtəsi.
Kodex / ChatGPT-abunə nəqliyyatı — bir modeli ChatGPT vasitəsilə idarə etmək ödənişli API açarı əvəzinə abunəlik.

[!TIP] Əgər modeli bağlı olmadan qapını işə salmağa başlasanız (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), cavablar deterministikdən gəlir ilə zarafat etmək beləliklə siz kanalları təsdiqləyə bilərsiniz və Həqiqi modeli qoşmadan əvvəl marşrutlaşdırma.

[!NOTE] AiHummer yalnız OpenAI ilə uyğun olanı göstərir POST /v1/chat/completions nöqtə. Var xeyr /v1/models və ya /v1/embeddings HTTP son nöqtəsi və idarəolunanlıq OTLP-push-dur (Prometheus yoxdur /metrics).

Növbəti haradır

Yerləşdirməyə hazır? Get Quraşdırma.
İlk qaçışı addım-addım getmək istəyirsiniz? Baxın Tez Başlanğıc.
Əvvəlcə zehni modeli istəyirsiniz? Oxuyun Giriş.