Асистематә ҭахрақәа — AiHummer Адокументациа

AiHummer хост-нативтә продуктуп: уи иныҟәоит арелизтә тарбол аиԥш systemd иаҵаҟа, абри аҟынтә аҭахрақәа барзаны имаҷуп. Иҵабыргу аамҭакала иҟоу адгылара ауп Linux хост PostgreSQL аманы. Зегьы егьырҭ — сайдкарқәа, иҵабыргу модель, авектортә склад — иалкаауп насгьы ишәылшоит иашәацҵа ашьҭахь аадминистраторатә UI аҟынтә.

[!NOTE] AiHummer хост-нативтә, Docker акымкуа. Уи дислоиуп тарбол аиԥш systemd иаҵаҟа /home/.aihummer аҟынтә. Шәара иашәҭахым аконтейнертә рантайм, Kubernetes ма аоркестраторзаалакь.

Аусуратә система

AiHummer иныҟәоит Linux мацара аҿы. Windows ма macOS сервер билд ыҟам — гейтуэй насгьы уи сайдкарқәа дара ипакетироуп архитектура-аканы Linux артефактқәа аиԥш насгьы дислоиуп systemd аманы. (Аклиент хазы мобильтәи десктоптәи аппуп; ари каналуп, сервер акымкуа.)

Иҿыцу 64-бит Linux дистрибуз systemd аманы.
x86_64 (amd64) ма arm64 — анинсталлер инанагоит иадгылоу архитектура-аканы бандл.
sudo/рут аамдара инсталл рут аҩразы насгьы systemd аиԥшрақәа рргистраразы.

Adatabaza

PostgreSQL ауп иҵабыргу аамҭакала иҟоу адгылара насгьы ак иҵабыргра ахыҵхырҭа аҭагылазаашьа зегьы рзы. pgcrypto ариагара иҭахуп — уи иадгылоит зашифрау акредитсиатә vault. Adatabaza акгьа, гейтуэй инышьҭихуеит иаамаҷу аиқәырха-мацара режим аҿы насгьы инанагоит акгьа ихымԥшу.

[!IMPORTANT] Иаргылатә pgcrypto шәара иашәхымоу adatabaza аҿы актәи аусура аԥхьа:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Гейтуэй иаауеит DSN ала AIHUMMER_DATABASE_URL аҟны. Рацәа-тенант аизардаразы ишәылшоит еицгьы иашәпинтә AIHUMMER_DB_APP_URL иаагоу aihummer_app роли ахь Postgres Row-Level Security арҿиаразы; локалтә инсталлқәа иаргылоит ари автоматтә. Adatabaza амигразқәа иаԥхьа-шәарҭоуп насгьы иргылоит автоматтә advisory лок аиԥш аладла пул аҿы.

Ахардуэр

Абарҭ ацифрақәа гидуп ак-хост дислои гейтуэй PostgreSQL аманы азы. Сайдкарқәа (STT/TTS, браузер, авектортә склад) рхатәы футпринт иацырҵоит насгьы аамҭакала идыргылоит ак хост аҿы маҷу адислоиқәа рзы мацара.

Профиль	CPU	RAM	Адиск	Аҵарбагақәа
Минимум (эвал)	2 vCPU	2 GB	10 GB	Гейтуэй + Postgres, mock модель, сайдкарқәа рымкуа
Иадыргылоу	4 vCPU	8 GB	40 GB SSD	Гейтуэй + Postgres + сайдкарқәак
Абжьы / локалтә модельқәа	8+ vCPU (GPU иалкаау)	16+ GB	80+ GB SSD	STT/TTS, эмбеддер, локалтә LLM эндпоинт

Адиск ахархәара ирацәахоит аиҿцәажәара ажурнал, амедиа блоб директориа (AIHUMMER_BLOB_DIR), адырра алагалара насгьы аудит аанхара рыла. Иашәырҿиа PostgreSQL абэкапқәа (pg_dump + WAL/PITR) урҭ рыла.

Сайдкарқәа (иалкаау)

Сайдкарқәа дара хазы HTTP аусурақәоуп, избан уи хатәы systemd аиԥшра аҵаҟа. Гейтуэй иаауеит урҭ ахь URL ала, абри аҟынтә сайдкар иныҟәоит ак хост аҿы, даҽа хост аҿы, ма ишәылшоит иашәпинтә иҟоу инстанс ахь. Дара зегьы хәыда/локалтәуп насгьы аамҭакала иҭахым ак ихадоу дислои азы.

Сайдкар	Default порт	Иарҿиоит
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` хархәартәқәа

Анинсталлер иалшоит иаргылара сайдкарқәа нативтә ма ишәылшоит иашәҭаҵа иҟоу URL ала — иашәырба Аинсталл.

LLM провайдерқәа

AiHummer аамҭакала иаҭахым ахуа модель. Уи иаусуеит ишьҭантәи хәыда/локалтә модельқәа насгьы Codex/ChatGPT-абонементтә транспорт ала; тенант-аканы BYOK аклавишқәа барзаны иалкаауп.

Иадгылоу провайдерқәа:

Anthropic.
OpenAI.
Избанзаалакь OpenAI-API-стандарт эндпоинт — локалтә модель серверқәа, OpenRouter, ма Gemini OpenAI-иадгылоу эндпоинт, ҿырԥшқәа.
Codex / ChatGPT-абонементтә транспорт — иашәырҿиа модель ChatGPT абонемент ала ихуэу API аклавиш акымкуа.

[!TIP] Шәара иашәнышьҭихыр гейтуэй модель ишәдымгылакәа (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), аҭакқәа аауеит детерминистикатә mock аҟынтә абри ишәылшоит аканалқәа насгьы ароутингтә рыҵабыргра иҵабыргу модель аҿаҵаргьаанӡа.

[!NOTE] AiHummer иаанарԥшуеит OpenAI-иадгылоу POST /v1/chat/completions эндпоинт мацара. Уи акгьа /v1/models ма /v1/embeddings HTTP эндпоинт ыҟам, насгьы аобсервабельтә OTLP-пуш (Prometheus /metrics ыҟам).

Иахьынтә ашьҭахь

Адислоиразы иҟазааит? Иашәца Аинсталл.
Иашәҭаху иашәырцәажәа актәи аус арбагала арбагала? Иашәырба Квикстарт.
Иашәҭаху ацәгьара модель раԥхьа? Иашәырԥхьа Алагалажәа.