AiHummer
Oʻzbekcha▾
Kirish
v1.0.x▾
v1.0.xstable
{ }Swagger
Ishni boshlash/Tizim talablari

Tizim talablari

v1.0.x · yangilandi 2026-06-26

AiHummer — host-native mahsulot: u systemd ostida release tarball sifatida ishlaydi, shu sababli talablar ataylab kichik. Yagona qatʼiy bogʻliqlik — PostgreSQL bilan Linux host. Boshqa hamma narsa — sidecar’lar, haqiqiy model, vektor doʻkoni — ixtiyoriy va keyinroq admin UI’dan qoʻshilishi mumkin.

[!NOTE] AiHummer host-native, Docker emas. U /home/.aihummer dan systemd ostida ishlaydigan tarball sifatida joylashtiriladi. Sizga konteyner ish vaqti muhiti, Kubernetes yoki biron orkestrator kerak emas.

Operatsion tizim

AiHummer faqat Linux’da ishlaydi. Windows yoki macOS server build’i yoʻq — gateway va uning sidecar’lari har bir arxitektura uchun Linux artefaktlari sifatida paketlanadi va systemd bilan joylashtiriladi. (Mijoz alohida mobil va ish stoli ilovasidir; bu kanal, server emas.)

  • systemd bilan zamonaviy 64-bitli Linux distributivi.
  • x86_64 (amd64) yoki arm64 — oʻrnatuvchi mos arxitektura bundle’ini tortib oladi.
  • Oʻrnatish ildizini yozish va systemd birliklarini roʻyxatga olish uchun sudo/root kirish.

Maʼlumotlar bazasi

PostgreSQL — yagona qatʼiy bogʻliqlik va barcha holat uchun yagona haqiqat manbai. pgcrypto kengaytmasi talab qilinadi — u shifrlangan hisob maʼlumotlari seyfini quvvatlaydi. Maʼlumotlar bazasisiz gateway qisqartirilgan faqat-salomatlik rejimida ishga tushadi va foydali hech narsa taqdim etmaydi.

[!IMPORTANT] Birinchi ishga tushirishdan oldin maqsadli maʼlumotlar bazasida pgcrypto ni yoqing:

CREATE EXTENSION IF NOT EXISTS pgcrypto;

Gateway AIHUMMER_DATABASE_URL dagi DSN orqali ulanadi. Koʻp ijarachilik izolyatsiyasi uchun qoʻshimcha ravishda AIHUMMER_DB_APP_URL ni cheklangan aihummer_app roliga yoʻnaltirib Postgres Row-Level Security’ni faollashtirishingiz mumkin; lokal oʻrnatishlar buni avtomatik sozlaydi. Maʼlumotlar bazasi migratsiyalari oldinga xavfsiz va owner pool ustida advisory lock ostida avtomatik qoʻllaniladi.

Apparat

Bu raqamlar gateway va PostgreSQL’ning bitta host’da joylashtirilishi uchun yoʻriqnomadir. Sidecar’lar (STT/TTS, brauzer, vektor doʻkoni) oʻz iz qoldiradi va odatda faqat kichik joylashtirishlar uchun xuddi shu host’ga joylashtiriladi.

Profil CPU RAM Disk Eslatmalar
Minimal (baholash) 2 vCPU 2 GB 10 GB Gateway + Postgres, mock model, sidecar’larsiz
Tavsiya etilgan 4 vCPU 8 GB 40 GB SSD Gateway + Postgres + bir nechta sidecar
Ovoz / lokal modellar 8+ vCPU (GPU ixtiyoriy) 16+ GB 80+ GB SSD STT/TTS, embedder, lokal LLM nuqtasi

Disk ishlatilishi suhbat tarixi, media blob katalogi (AIHUMMER_BLOB_DIR), bilim qabul qilish va audit saqlash bilan oʻsadi. PostgreSQL zaxiralarini (pg_dump + WAL/PITR) shunga koʻra rejalashtiring.

Sidecar’lar (ixtiyoriy)

Sidecar’lar — alohida HTTP xizmatlar, har biri oʻz systemd birligi ostida. Gateway ularga URL orqali murojaat qiladi, shu sababli sidecar xuddi shu host’da, boshqa host’da ishlashi yoki mavjud instansga yoʻnaltirishingiz mumkin. Ularning hammasi bepul/lokal va asosiy joylashtirish uchun hech qachon talab qilinmaydi.

Sidecar Standart port Yoqadi
STT (faster-whisper) 8001 Ovozli turnlar uchun nutqdan matnga
TTS (edge-tts) 8002 Ovozli turnlar uchun matndan nutqqa
Diarize (pyannote) 8003 Soʻzlovchi diarizatsiyasi
Voiceclone (OpenVoice V2) 8004 Ovoz klonlash
Video (ffmpeg) 8005 Videoni tushunish
SearXNG 8888 web_search asbobi
Chrome/CDP 9222 browser / computer asboblari

Oʻrnatuvchi sidecar’larni natively taʼminlay oladi yoki mavjudini URL orqali biriktirishingiz mumkin — Oʻrnatish ga qarang.

LLM provayderlar

AiHummer hech qachon pullik modelni talab qilmaydi. U quticha ichida bepul/lokal modellarda va Codex/ChatGPT-obuna transportida ishlaydi; har bir ijarachi uchun BYOK kalitlari qatʼiy ravishda ixtiyoriy.

Qoʻllab-quvvatlanadigan provayderlar:

  • Anthropic.
  • OpenAI.
  • Har qanday OpenAI-API-standart nuqtasi — masalan, lokal model serverlari, OpenRouter yoki Gemini’ning OpenAI bilan mos nuqtasi.
  • Codex / ChatGPT-obuna transporti — modelni hisoblangan API kaliti orqali emas, balki ChatGPT obunasi orqali boshqaring.

[!TIP] Agar gateway-ni model ulanmagan holda (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL) ishga tushirsangiz, javoblar deterministik mock’dan keladi, shunda haqiqiy modelni ulashdan oldin kanallar va yoʻnaltirishni tekshirishingiz mumkin.

[!NOTE] AiHummer faqat OpenAI bilan mos POST /v1/chat/completions nuqtasini ochadi. /v1/models yoki /v1/embeddings HTTP nuqtasi yoʻq, kuzatuvchanlik esa OTLP-push (Prometheus /metrics yoʻq).

Keyingi qadam qayerda

  • Joylashtirishga tayyormisiz? Oʻrnatish ga oʻting.
  • Birinchi ishga tushirishni bosqichma-bosqich koʻrib chiqmoqchimisiz? Tezkor boshlash ga qarang.
  • Avval fikriy modelni istaysizmi? Kirish ni oʻqing.