Сістэмныя патрабаванні — AiHummer Дакументацыя

AiHummer — гэта прадукт, прызначаны для працы на хосце: ён запускаецца як выдаваны тарбол пад systemd, таму патрабаванні наўмысна мінімальныя. Адзінай суровай залежнасцю з’яўляецца Linux-хост з PostgreSQL. Усё астатняе — сайдкары, сапраўдная мадэль, вектарнае сховішча — неабавязкова і можа быць дададзена пазней праз адміністрацыйны інтэрфейс.

[!NOTE] AiHummer — гэта хост-арыгінальны, не Docker. Ён размяшчаецца як tarball, што працуе пад systemd ад ~/.aihummer (домашні каталог карыстальніка, які запусціў ўсталёўшчык). Вам не патрэбна асяроддзе выканання кантэйнераў, 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 роль для актывацыі бяспекі на ўзроўні радкоў Postgres; лакальныя ўстаноўкі робяць гэта аўтаматычна. Міграцыі базы дадзеных бяспечныя наперад і прымяняюцца аўтаматычна пад кансультацыйнай блакіроўкай уласніка пула.

Апаратнае забеспячэнне

Гэтыя лічбы служаць арыенцірам для разгортвання шлюза разам з PostgreSQL на адным хосце. Дадатковыя кампаненты (STT/TTS, браўзер, сховішча вектараў) дадаюць сваю нагрузку і звычайна размяшчаюцца на тым жа хосце толькі для невялікіх разгортванняў.

Профіль	ЦПУ	АПВ	Дыск	Нататкі
Мінімум (ацэнка)	2 віртуальныя цэнтральныя працэсарныя адзінкі	2 ГБ	10 ГБ	Gateway + Postgres, мадэль-макет, без сайдкары
Рэкамендавана	4 віртуальныя цэнтральныя працэсарныя адзінкі	8 ГБ	40 ГБ SSD	Шлюз + Postgres + некалькі дадатковых сэрвісаў
Голас / мясцовыя мадэлі	8+ віртуальных ЦПУ (GPU па жаданні)	16+ ГБ	80+ ГБ SSD	STT/TTS, убудавальнік, лакальны LLM-канчатковы пункт

Выкарыстанне дыска расце разам з гісторыяй размоў, каталог медыяфайлаў (AIHUMMER_BLOB_DIR), уцягванне ведаў і захаванне аўдытных запісаў. Плануйце рэзервовыя копіі PostgreSQL (pg_dump + WAL/PITR) адпаведна.

Бакавыя прывадныя вазкі (па жаданні)

Бакавыя калёсы адмысловыя HTTP-службыкожны пад сваёй уласнай адзінкай systemd. Шлюз дасягае іх па URL, таму сайдкар можа працаваць на тым жа хосце, на іншым хосце, або вы можаце паказаць на існуючы экземпляр. Усе яны бясплатныя/мясцовыя і ніколі не патрабуюцца для базавай разгорткі.

Сідкары	Порт па змаўчанні	Дазваляе
STT (хутчэйшы шэпт)	8001	Распазнаванне голасу для ператварэння ў тэкст
TTS (edge-tts)	8002	Тэкст у размову для галасавых паваротаў
Відэа (ffmpeg)	8005	Разуменне відэа
SearXNG	8888	Гэта `web_search` інструмент
Chrome/CDP	9222	Гэта `browser` / `computer` інструменты

STT, TTS, відэа, вэб-пошук (SearXNG) і браўзер (CloakBrowser) — усе ўсталёўваюцца з скрынкі ўсталёўшчыкам. Кампаненты пошуку і браўзера пастаўляюцца ўнутры падпісанага бандла ўсталёўшчыка і ставяцца афлайн: выключыце іх праз --no-search / --no-browser або замест лакальнай устаноўкі падключыце ўжо працуючы экзэмпляр праз --external-search=URL / --external-browser=URL. Галасавыя сайдкары можна прапусціць пераменнымі AIHUMMER_SKIP_*. Семантычны ўбівальнік падаць згоду (--with-embedder): гэта загружае PyTorch (сотні МБ), а без яго памяць вертаецца да лексічнага пошуку. Глядзіце Устаноўка.

[!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-пуш (без Prometheus) /metrics).

Куды далей

Гатовы да разгортвання? Перайдзіце на Устаноўка.
Хочаце прайсці першы запуск крок за крокам? Глядзіце Хуткі старт.
Хочаце спачатку псіхалагічную мадэль? Чытайце Уводзіны.