Системалык талаптар — AiHummer Документация

AiHummer — бул хост-нативдик продукт: ал systemd астында релиз tarball катары иштейт, ошондуктан талаптар атайылап чакан. Жалгыз катуу көз карандылык — бул PostgreSQL менен Linux хосту. Калгандын баары — sidecar’лар, чыныгы модель, вектор сактагыч — кошумча жана кийинчерээк админ UI’ден кошулушу мүмкүн.

[!NOTE] AiHummer хост-нативдик, Docker эмес. Ал /home/.aihummer’ден systemd астында иштеген tarball катары жайылат. Сизге контейнер чөйрөсү, Kubernetes же кандайдыр бир оркестратор керек эмес.

Операциялык система

AiHummer Linux’та гана иштейт. Windows же macOS сервер бандлы жок — шлюз жана анын sidecar’лары ар бир архитектурага ылайык Linux артефактары катары таңгакталат жана systemd менен жайылат. (Кардар — бул өзүнчө мобилдик & десктоп тиркеме; ал — канал, сервер эмес.)

systemd менен заманбап 64-биттик Linux дистрибутиву.
x86_64 (amd64) же arm64 — орноткуч дал келген архитектурага ылайык бандлды тартат.
Орнотуу тамырын жазуу жана systemd бирдиктерин каттоо үчүн sudo/root жеткиликтүүлүгү.

Маалымат базасы

PostgreSQL — бул жалгыз катуу көз карандылык жана бардык абал үчүн бирдиктүү чындык булагы. pgcrypto кеңейтүүсү талап кылынат — ал шифрленген каттоо маалыматтарынын сейфин колдойт. Маалымат базасысыз шлюз кыскартылган health-only режиминде иштеп баштайт жана эч кандай пайдалуу нерсе тейлебейт.

[!IMPORTANT] Биринчи иштетүүгө чейин максаттуу маалымат базасында pgcrypto’ну күйгүзүңүз:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Шлюз AIHUMMER_DATABASE_URL ичиндеги DSN аркылуу туташат. Көп ижарачылык изоляция үчүн сиз кошумча түрдө AIHUMMER_DB_APP_URL’ди Postgres Row-Level Security’ни жандыруу үчүн чектелген aihummer_app ролуна багыттай аласыз; локалдык орнотуулар муну автоматтык түрдө орнотот. Маалымат базасынын миграциялары алдыга карай коопсуз жана ээ пулунда консультативдик кулпу астында автоматтык колдонулат.

Аппараттык камсыздоо

Бул сандар шлюз плюс PostgreSQL’дин бир хосттук жайылтуусу үчүн жетекчилик болуп саналат. Sidecar’лар (STT/TTS, браузер, вектор сактагыч) өздөрүнүн изин кошушат жана адатта чакан жайылтуулар үчүн гана бир хостко жайгаштырылат.

Профиль	CPU	RAM	Диск	Эскертүүлөр
Минимум (баалоо)	2 vCPU	2 GB	10 GB	Шлюз + Postgres, мак модель, sidecar’сыз
Сунушталган	4 vCPU	8 GB	40 GB SSD	Шлюз + Postgres + бир нече sidecar
Үн / локалдык моделдер	8+ vCPU (GPU кошумча)	16+ GB	80+ GB SSD	STT/TTS, эмбеддер, локалдык LLM эндпойнт

Дисктин колдонулушу сүйлөшүү тарыхы, медиа blob каталогу (AIHUMMER_BLOB_DIR), билим жүктөө жана аудит сактоо менен өсөт. PostgreSQL камдарын (pg_dump + WAL/PITR) ошого жараша пландаштырыңыз.

Sidecar’лар (кошумча)

Sidecar’лар — бул өзүнчө HTTP кызматтар, ар бири өз systemd бирдигинин астында. Шлюз аларга 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-стандарттык эндпойнт — мисалы, локалдык модель серверлери, OpenRouter же Gemini’дин OpenAI-шайкеш эндпойнту.
Codex / ChatGPT-жазылуу транспорту — эсептелген API ачкычынын ордуна ChatGPT жазылуусу аркылуу моделди башкарыңыз.

[!TIP] Эгер сиз шлюзду модель байланышпай туруп иштетсеңиз (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), жооптор детерминисттик мактан келет, ошондуктан чыныгы моделди туташтырганга чейин каналдарды жана багыттоону текшере аласыз.

[!NOTE] AiHummer OpenAI-шайкеш POST /v1/chat/completions эндпойнтун гана сунуштайт. /v1/models же /v1/embeddings HTTP эндпойнту жок, ал эми мониторинг OTLP-push (Prometheus /metrics жок).

Кийинки кадам

Жайылтууга даярсызбы? Орнотуу’га өтүңүз.
Биринчи иштетүүнү кадам-кадам менен басып өткүңүз келеби? Тез баштоо караңыз.
Алгач акылдуу моделди каалайсызбы? Киришүү окуңуз.