Wymagania systemowe — AiHummer Dokumenty

AiHummer to produkt natywny dla hosta: działa jako wydanie w postaci tarballa pod systemd, więc wymagania są celowo niewielkie. Jedynym twardym wymaganiem jest host Linux z PostgreSQL. Wszystko inne — sidecary, prawdziwy model, magazyn wektorów — jest opcjonalne i można to dodać później z poziomu panelu administracyjnego.

[!NOTE] AiHummer jest natywny dla hosta, nie Docker. Rozpakowuje się jako archiwum tar działające pod systemd z ~/.aihummer (katalog domowy użytkownika, który uruchomił instalator). Nie potrzebujesz środowiska uruchomieniowego kontenerów, Kubernetes ani żadnego dyrygent.

System operacyjny

AiHummer działa na Tylko Linux. Nie ma wersji serwerowej Windows ani macOS — brama i jej sidecary są pakowane jako artefakty Linuksa dla poszczególnych architektur i wdrażane przy użyciu systemd. (Klient to osobna aplikacja mobilna i komputerowa; to jest kanał, a nie serwer.)

Nowoczesna 64-bitowa dystrybucja Linuksa z systemd.
x86_64 (amd64) lub arm64 — instalator pobiera pasujący pakiet dla danej architektury.
sudodostęp root nie jest ściśle wymagane: normalna instalacja przebiega przez sudo, ale uruchomienie instalatora bez uprawnień root instaluje AiHummer bez użycia roota tryb pod systemd --user — zobaczyć Instalacja.

Baza danych

PostgreSQL jest tylko twarda zależność i jedyne źródło prawdy dla całego stanu. pgcrypto rozszerzenie jest wymagany — wspiera zaszyfrowany sejf poświadczeń. Bez bazy danych bramka uruchamia się w ograniczonym trybie tylko zdrowie i nie udostępnia niczego użytecznego.

[!IMPORTANT] Włącz pgcrypto w docelowej bazie danych przed pierwszym uruchomieniem:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Brama łączy się poprzez DSN w AIHUMMER_DATABASE_URL. Dla izolacji wielodostępnej możesz dodatkowo wskazać AIHUMMER_DB_APP_URL w ograniczonym aihummer_app rola do aktywowania bezpieczeństwa na poziomie wiersza w Postgres; lokalne instalacje ustawiają to automatycznie. Migracje baz danych są bezpieczne w przód i stosowane automatycznie pod blokadą doradczą w pulę właściciela.

Sprzęt

Te liczby stanowią wskazówki dla wdrożenia bramy i PostgreSQL na jednym hoście. Sidecary (STT/TTS, przeglądarka, magazyn wektorów) dodają własny ślad i zazwyczaj są umieszczane na tym samym hoście tylko w przypadku małych wdrożeń.

Profil	Procesor	RAM	Dysk	Notatki
Minimum (ocena)	2 vCPU	2 GB	10 GB	Gateway + Postgres, model mock, brak sidecarów
Polecany	4 vCPU	8 GB	40 GB SSD	Gateway + Postgres + kilka sidecarów
Modele głosowe / lokalne	8+ vCPU (GPU opcjonalnie)	16+ GB	80+ GB SSD	STT/TTS, osadzacz, lokalny punkt końcowy LLM

Użycie dysku rośnie wraz z historią rozmów, katalogiem blobów multimedialnych (AIHUMMER_BLOB_DIR), pozyskiwanie wiedzy i przechowywanie audytów. Planuj kopie zapasowe PostgreSQL (pg_dump + WAL/PITR) odpowiednio.

Boksy boczne (opcjonalnie)

Boczne wózki są oddzielne usługi HTTP, każdy pod własną jednostką systemd. Brama osiąga je poprzez URL, więc sidecar może działać na tym samym hoście, na innym hoście lub możesz wskazać istniejącą instancję. Wszystkie są darmowe/lokalne i nigdy nie są wymagane do podstawowego wdrożenia.

Boksykar	Domyślny port	Umożliwia
STT (faster-whisper)	8001	Rozpoznawanie mowy na tekst dla rozmów głosowych
TTS (edge-tts)	8002	Syntezator mowy dla zmian głosu
Wideo (ffmpeg)	8005	Rozumienie wideo
SearXNG	8888	Ten `web_search` narzędzie
Chrome/CDP	9222	Ten `browser` / `computer` narzędzia

STT, TTS, wideo, wyszukiwanie w sieci (SearXNG) i przeglądarka (CloakBrowser) są wszystkie instalowane od razu przez instalator. Pakiety wyszukiwania i przeglądarki są dostarczane w podpisanym bundlu instalatora i instalowane offline: wyłączysz je flagami --no-search / --no-browser albo podłączysz już działającą instancję flagami --external-search=URL / --external-browser=URL zamiast instalacji lokalnej. Głosowe sidecary pominiesz zmiennymi AIHUMMER_SKIP_*. Osadzacz semantyczny jest dobrowolny udział (--with-embedder): pobiera PyTorch (setki MB), a bez niego pamięć wraca do wyszukiwania leksykalnego. Zobacz Instalacja.

[!NOTE] Node.js (wersja 20 lub nowsza) również jest dostarczany w bundlu instalatora i instalowany offline, więc wtyczki Node.js — aplikacja AiHummer, pocket-agent i konektory kanałów — działają od razu nawet na dystrybucjach, których własny Node.js jest zbyt stary.

Dostawcy LLM

AiHummer nigdy nie wymaga płatnego modelu. Działa od razu na darmowych/lokalnych modelach oraz przy transporcie z subskrypcją Codex/ChatGPT; klucze BYOK dla poszczególnych najemców są całkowicie opcjonalne.

Obsługiwani dostawcy:

Antropiczny.
OpenAI.
Każdy standardowy punkt końcowy OpenAI-API — lokalne serwery modeli, OpenRouter, lub Na przykład punkt końcowy Gemini zgodny z OpenAI.
Transport subskrypcji Codex / ChatGPT — przeprowadzić model przez ChatGPT subskrypcja zamiast fakturowanego klucza API.

[!TIP] Jeśli uruchomisz bramę bez podłączonego modelu (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), odpowiedzi pochodzą od deterministycznego drwić więc możesz weryfikować kanały i trasowanie przed połączeniem prawdziwego modelu.

[!NOTE] AiHummer ujawnia tylko te zgodne z OpenAI POST /v1/chat/completions punkt końcowy. Jest nie /v1/models lub /v1/embeddings punkt końcowy HTTP, oraz obserwowalność to OTLP-push (bez Prometheus) /metrics).

Dokąd dalej

Gotowy do wdrożenia? Przejdź do Instalacja.
Chcesz przejść pierwszy bieg krok po kroku? Zobacz Szybki start.
Chcesz najpierw model mentalny? Przeczytaj Wprowadzenie.