AiHummer
Türkmençe▾
Gir
v1.0.x▾
v1.0.xstable
{ }Swagger
Başlangyç/Ulgam Talaplary

Ulgam Talaplary

v1.0.x · täzelendi 2026-06-26

AiHummer host-ýerli önüm: ol systemd astynda reliz tarball-y hökmünde işleýär, şonuň üçin talaplar bilkastlaýyn kiçi. Ýeke-täk berk garaşlylyk PostgreSQL bilen Linux host. Galan ähli zat — sidecar-lar, hakyky model, wektor saklawy — isleg boýunça we soňra admin UI-den goşulyp bilner.

[!NOTE] AiHummer host-ýerli, Docker däl. Ol /home/.aihummer-dan systemd astynda işleýän tarball hökmünde ýerleşdirilýär. Size konteýner ortasy, Kubernetes ýa-da islendik orkestrator gerek däl.

Operasion ulgam

AiHummer diňe Linux-da işleýär. Windows ýa-da macOS serwer gurluşy ýok — gateway we onuň sidecar-lary arhitektura boýunça Linux artefaktlary hökmünde gaplanan we systemd bilen ýerleşdirilýär. (Müşderi aýratyn mobil & desktop programma; ol kanal, serwer däl.)

  • systemd bilen häzirki zaman 64-bitli Linux distribusiýasy.
  • x86_64 (amd64) ýa-da arm64 — gurnaýjy gabat gelýän arhitektura paketini çekýär.
  • Gurnama köküni ýazmak we systemd birliklerini hasaba almak üçin sudo/root girişi.

Maglumat bazasy

PostgreSQL ýeke-täk berk garaşlylyk we ähli ýagdaý üçin ýeke-täk hakykat çeşmesi. pgcrypto giňeltmesi talap edilýär — ol şifrlenen kredensial sandygyny goldaýar. Maglumat bazasy bolmazdan gateway azaldylan diňe-saglyk režiminde başlaýar we peýdaly hiç zat hyzmat etmeýär.

[!IMPORTANT] Ilkinji işleýişden ozal maksat maglumat bazasynda pgcrypto-ny işjeňleşdiriň:

CREATE EXTENSION IF NOT EXISTS pgcrypto;

Gateway AIHUMMER_DATABASE_URL-däki DSN arkaly birikýär. Köp-kärendeçili izolýasiýa üçin siz goşmaça AIHUMMER_DB_APP_URL-i çäklendirilen aihummer_app roluna gönükdirip Postgres Row-Level Security-i işjeňleşdirip bilersiňiz; ýerli gurnamalar muny awtomatiki belleýär. Maglumat bazasy migrasiýalary öňe-howpsuz we eýe pulunda maslahat gulpy astynda awtomatiki ulanylýar.

Apparat

Bu sanlar gateway goşmaça PostgreSQL-iň ýeke-host ýerleşdirmesi üçin görkezme. Sidecar-lar (STT/TTS, brauzer, wektor saklawy) öz aýak yzlaryny goşýar we adatça diňe kiçi ýerleşdirmeler üçin şol bir hostda ýerleşdirilýär.

Profil CPU RAM Disk Bellikler
Minimum (eval) 2 vCPU 2 GB 10 GB Gateway + Postgres, mock model, sidecar ýok
Maslahat berilýän 4 vCPU 8 GB 40 GB SSD Gateway + Postgres + birnäçe sidecar
Ses / ýerli modeller 8+ vCPU (GPU isleg boýunça) 16+ GB 80+ GB SSD STT/TTS, embedder, ýerli LLM nokady

Disk ulanyşy gepleşik taryhy, media blob katalogy (AIHUMMER_BLOB_DIR), bilim kabul etmegi we audit saklamagy bilen ösýär. PostgreSQL zapaslaryny (pg_dump + WAL/PITR) degişlilikde meýilleşdiriň.

Sidecar-lar (isleg boýunça)

Sidecar-lar aýratyn HTTP hyzmatlary, her biri öz systemd birliginiň astynda. Gateway olara URL boýunça ýetýär, şonuň üçin sidecar şol bir hostda, başga hostda işläp biler ýa-da siz bar bolan nusga gönükdirip bilersiňiz. Olaryň hemmesi mugt/ýerli we esasy ýerleşdirme üçin hiç haçan talap edilmeýär.

Sidecar Default port Işjeňleşdirýär
STT (faster-whisper) 8001 Ses gezekleri üçin gepleşik-tekstine
TTS (edge-tts) 8002 Ses gezekleri üçin tekst-gepleşige
Diarize (pyannote) 8003 Geplänleri tapawutlandyrmak
Voiceclone (OpenVoice V2) 8004 Ses klonlamak
Video (ffmpeg) 8005 Wideo düşünmek
SearXNG 8888 web_search guraly
Chrome/CDP 9222 browser / computer gurallary

Gurnaýjy sidecar-lary ýerli üpjün edip biler ýa-da siz bar bolan birini URL boýunça birikdirip bilersiňiz — Gurnama sahypasyna serediň.

LLM üpjünçiler

AiHummer hiç haçan tölegli model talap etmeýär. Ol gutudan çykan badyna mugt/ýerli modellerde we Codex/ChatGPT-abuna transportynda işleýär; kärendeçi boýunça BYOK açarlary doly isleg boýunça.

Goldanýan üpjünçiler:

  • Anthropic.
  • OpenAI.
  • Islendik OpenAI-API-standart nokady — ýerli model serwerleri, OpenRouter ýa-da Gemini-niň OpenAI-gabat gelýän nokady, mysal üçin.
  • Codex / ChatGPT-abuna transporty — modeli tölegli API açaryndan däl-de, ChatGPT abunasy arkaly sürüň.

[!TIP] Eger gateway-i model birikdirilmän başlasaňyz (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), jogaplar deterministik mock-dan gelýär, şeýdip siz hakyky modeli birikdirmezden ozal kanallary we marşrutlaşdyrmagy barlap bilersiňiz.

[!NOTE] AiHummer diňe OpenAI-gabat gelýän POST /v1/chat/completions nokadyny açýar. /v1/models ýa-da /v1/embeddings HTTP nokady ýok, we synçylyk OTLP-push (Prometheus /metrics ýok).

Indiki nirä

  • Ýerleşdirmäge taýýarmy? Gurnama-a giriň.
  • Ilkinji işleýişi ädimme-ädim geçmek isleýärsiňizmi? Çalt başlangyjy görüň.
  • Ilki aňyýet modelini isleýärsiňizmi? Girişi okaň.