Tizim talablari — AiHummer Hujjatlar

AiHummer host-ga mos mahsulotdir: u systemd ostida release tarball sifatida ishlaydi, shuning uchun talablar ataylab kichik qilib belgilangan. Yagona qattiq bog‘liqlik — bu PostgreSQL bilan Linux hostidir. Qolgan barcha narsalar — sidecar-lar, haqiqiy model, vektor do‘koni — ixtiyoriy bo‘lib, keyinchalik admin UI orqali qo‘shilishi mumkin.

[!NOTE] AiHummer bu mezbon-tug‘ilgan, Docker emas. U tarball sifatida ishga tushiriladi systemd dan ~/.aihummer (foydalanuvchi ishga tushirgan foydalanuchi uy katalogi o‘rnatish dasturi). Sizga konteyner ishlash muhiti, Kubernetes yoki boshqa hech narsa kerak emas orkestrator.

Operatsion tizim

AiHummer ishlaydi Faqat Linux. Windows yoki macOS server qurilmasi yo‘q — gateway va uning sidecar’lari arxitekturaga mos Linux fayllari sifatida qadoqlanadi va systemd yordamida joylashtiriladi. (Mijoz alohida mobil va desktop ilova; bu server emas, balki kanal.)

Hozirgi 64-bitli Linux taqsimoti bilan systemd.
x86_64 (amd64) yoki arm64 — o’rnatuvchi mos arxitektura paketini tortib oladi.
sudo/rootga kirish huquqi qat’iy majburiy emas: oddiy o’rnatish orqali ishlaydi sudo, lekin o‘rnatgichni rootsiz ishga tushirish AiHummerni rootsiz o‘rnatadi rejim ostida systemd --user — ko‘rish O’rnatish.

Ma’lumotlar bazasi

PostgreSQL bu faqat qattiq bog‘liqlik va barcha holatlar uchun yagona haqiqat manbai. pgcrypto kengaytma majburiy — bu shifrlangan credential xazinasini qo‘llab-quvvatlaydi. Bazasi bo‘lmasa, gateway cheklangan faqat sog‘liq rejimida ishga tushadi va foydali hech narsani taqdim etmaydi.

[!IMPORTANT] Yoqish pgcrypto birinchi ishga tushirishdan oldin maqsadli ma’lumotlar bazasida:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Shlyuz DSN orqali ulanadi AIHUMMER_DATABASE_URL. Ko‘p foydalanuvchili izolyatsiya uchun siz qo‘shimcha ravishda ko‘rsatishingiz mumkin AIHUMMER_DB_APP_URL cheklangan joyda aihummer_app Postgres qator darajasidagi xavfsizlikni faollashtirish uchun rol; mahalliy o‘rnatishlar buni avtomatik tarzda sozlaydi. Ma’lumotlar bazasi migratsiyalari oldinga mos va egasi havzasidagi maslahatli blok ostida avtomatik tarzda qo‘llanadi.

Uskuna

Ushbu raqamlar gateway va PostgreSQL’ni yagona serverda joylashtirish bo‘yicha yo‘l-yo‘riqdir. Sidecar’lar (STT/TTS, brauzer, vektor ombori) o‘zlarining foydalanuvchi izini qo‘shadi va odatda faqat kichik joylashtirishlar uchun bir xil serverga joylashtiriladi.

Profil	CPU	RAM	Disk	Eslatmalar
Minimum (baholash)	2 vCPU	2 GB	10 GB	Gateway + Postgres, soxta model, sidecarlarsiz
Tavsiya etilgan	4 vCPU	8 GB	40 GB SSD	Gateway + Postgres + bir nechta sidecarlar
Ovoz / mahalliy modellar	8+ vCPU (GPU ixtiyoriy)	16+ GB	80+ GB SSD	STT/TTS, embedder, mahalliy LLM tugun nuqtasi

Diskdan foydalanish suhbat tarixiga, media blob katalogiga qarab ortadi (AIHUMMER_BLOB_DIR), bilimni qabul qilish va auditni saqlash. PostgreSQL zaxira nusxalarini shunga ko‘ra rejalashtiring (pg_dump + WAL/PITR).

Yon aravachalar (ixtiyoriy)

Yon aravalar alohida HTTP xizmatlari, har biri o’zining systemd birligi ostida. Shlyuz ularga URL orqali yetib boradi, shuning uchun sidecar bir xil mezbon kompyuterda, boshqa mezbon kompyuterda ishlashi mumkin yoki siz mavjud nusxaga yo’naltirishingiz mumkin. Ularning barchasi bepul/mahalliy va asosiy joylashtirish uchun hech qachon talab qilinmaydi.

Yon arava	Standart port	Yoqadi
STT (tezroq-pishiq)	8001	Nutqni matnga aylantirish ovoz navbatlari uchun
TTS (edge-tts)	8002	Ovoz navbati uchun matndan nutqqa
Video (ffmpeg)	8005	Video tushunish
SearXNG	8888	`web_search` asbob
Chrome/CDP	9222	`browser` / `computer` asboblar

STT, TTS, video, veb qidiruv (SearXNG) va brauzer (CloakBrowser) — barchasi o‘rnatish dasturi tomonidan qutidan chiqqan holda o‘rnatiladi. Qidiruv va brauzer fayllari imzolangan o‘rnatuvchi to‘plami ichida keladi va oflayn o‘rnatiladi: ularni --no-search / --no-browser bilan o‘chiring, yoki lokal o‘rnatish o‘rniga --external-search=URL / --external-browser=URL bilan o‘zingiz allaqachon ishlatayotgan instansiyani ulang. Ovozli sidecarlardan o‘tib ketish uchun AIHUMMER_SKIP_* o‘zgaruvchilaridan foydalaning. Semantik o’rnatuvchi rozilik berish (--with-embedder): bu PyTorch ni tortadi (yuzlab MB), va u bo‘lmasa xotira leksik qidiruvga qaytadi. Ko‘ring O’rnatish.

[!NOTE] Node.js (20 yoki undan yangi versiya) ham o‘rnatuvchi to‘plami ichida keladi va oflayn o‘rnatiladi, shuning uchun Node.js plaginlari — AiHummer ilovasi, pocket-agent va kanal ulagichlari — o‘z Node.js versiyasi juda eski bo‘lgan distributivlarda ham qutidan chiqqan holda ishlaydi.

LLM ta’minlovchilari

AiHummer hech qachon pullik modelni talab qilmaydi. U bepul/mahalliy modellar va Codex/ChatGPT obunasi transportida tayyor holda ishlaydi; har bir ijarachiga oid BYOK kalitlari qat’iyan ixtiyoriydir.

Qo‘llab-quvvatlanadigan provayderlar:

Antropik.
OpenAI.
Har qanday OpenAI-API-standart tugun nuqtasi — mahalliy model serverlari, OpenRouter yoki Masalan, Gemini’ning OpenAI bilan mos keladigan tugun nuqtasi.
Kodni / ChatGPT-obuna transporti — modelni ChatGPT orqali boshqarish to‘lov qilingan API kaliti o‘rniga obuna.

[!TIP] Agar siz eshikni modellashtirilmagan holda ishga tushirsangiz (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), javoblar deterministikdan keladi masxara qilmoq shuning uchun siz kanallarni tekshirishingiz va haqiqiy model bilan ulanishdan oldin marshrutlashtirish.

[!NOTE] AiHummer faqat OpenAI bilan mos keladiganini ochib beradi POST /v1/chat/completions endpoint. Bu bor yo‘q /v1/models yoki /v1/embeddings HTTP endpoint va kuzatiluvchanlik OTLP-push (Prometheus yo‘q) /metrics).

Keyingi qayerga

Joylashtirishga tayyormisiz? Ga boring O’rnatish.
Birinchi yugurishni qadam-baqadam bajarishni xohlaysizmi? Qarang Tez boshlash.
Avvalo aqliy modelni xohlaysizmi? O’qish Kirish.