Sistem Gereksinimleri — AiHummer Belgeler

AiHummer, ana bilgisayar üzerinde çalışan yerel bir üründür: systemd altında bir sürüm tarball olarak çalışır, bu nedenle gereksinimler kasıtlı olarak küçüktür. Tek zorunlu bağımlılık, PostgreSQL ile bir Linux ana bilgisayarıdır. Diğer her şey — yan hizmetler, gerçek bir model, bir vektör deposu — isteğe bağlıdır ve daha sonra yönetici kullanıcı arayüzünden eklenebilir.

[!NOTE] AiHummer şudur ana bilgisayara ait, Docker değil. Bir tarball olarak çalıştırılarak dağıtılır systemd’den ~/.aihummer (işlemi başlatan kullanıcının ana dizini yükleyici). Bir konteyner çalışma zamanı, Kubernetes veya herhangi bir şeye ihtiyacınız yok orkestratör

İşletim sistemi

AiHummer çalışıyor Sadece Linux. Windows veya macOS sunucu sürümü yok — geçit ve yan servisleri mimariye göre Linux paketleri olarak paketlenir ve systemd ile dağıtılır. (İstemci ayrı bir mobil ve masaüstü uygulamasıdır; bu bir kanal, sunucu değil.)

64 bit modern bir Linux dağıtımı ile systemd.
x86_64 (amd64) veya arm64 — yükleyici, eşleşen mimariye göre paketi çeker.
sudo/root erişimi kesin olarak gerekli değil: normal bir kurulum şu şekilde çalışır sudo, fakat yükleyiciyi root olmadan çalıştırmak AiHummer’ı rootsuz olarak kurar mod altında systemd --user — görmek Kurulum.

Veritabanı

PostgreSQL şudur sadece sıkı bağımlılık ve tüm durum için tek gerçek kaynağı. pgcrypto uzantı gerekli — şifrelenmiş kimlik bilgisi deposunu destekler. Bir veritabanı olmadan, ağ geçidi azaltılmış sadece sağlık modunda başlar ve hiçbir faydalı şey sunmaz.

[!IMPORTANT] Etkinleştir pgcrypto ilk çalıştırmadan önce hedef veritabanında:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Geçit, bir DSN üzerinden bağlanır AIHUMMER_DATABASE_URL. Çok kiracılı izolasyon için ayrıca işaret edebilirsiniz AIHUMMER_DB_APP_URL sınırlı bir alanda aihummer_app Postgres Satır Düzeyi Güvenliğini etkinleştirmek için rol; yerel kurulumlar bunu otomatik olarak ayarlar. Veritabanı geçişleri ileriye dönük güvenlidir ve sahip havuzunda danışman kilidi altında otomatik olarak uygulanır.

Donanım

Bu rakamlar, ağ geçidi ve PostgreSQL için tek sunuculu bir kurulum rehberidir. Yan arabalar (STT/TTS, tarayıcı, vektör depolama) kendi kaynak kullanımını ekler ve genellikle sadece küçük kurulumlar için aynı sunucuya yerleştirilir.

Profil	İşlemci	RAM	Disk	Notlar
Minimum (değerlendir)	2 vCPU	2 GB	10 GB	Gateway + Postgres, sahte model, yan araç yok
Tavsiye edilen	4 vCPU	8 GB	40 GB SSD	Gateway + Postgres + birkaç yan servis
Ses / yerel modeller	8+ vCPU (GPU opsiyonel)	16+ GB	80+ GB SSD	STT/TTS, gömme birimi, yerel LLM uç noktası

Disk kullanımı, sohbet geçmişi ve medya blob dizini ile birlikte artar (AIHUMMER_BLOB_DIR), bilgi edinme ve denetim saklama. PostgreSQL yedeklerini buna göre planlayın (pg_dump + WAL/PITR).

Yan arabalar (isteğe bağlı)

Yan arabalar ayrı HTTP servisleri, her biri kendi systemd birimi altında. Ağ geçidi onlara URL ile ulaşır, bu nedenle bir yan arabirim aynı ana bilgisayarda, başka bir ana bilgisayarda çalışabilir veya mevcut bir örneğe işaret edebilirsiniz. Hepsi ücretsiz/yerel ve temel bir dağıtım için asla gerekli değildir.

Yardımcı Araç	Varsayılan port	Etkinleştirir
STT (daha hızlı fısıltı)	8001	Sesli dönüşler için konuşmayı metne çevirme
TTS (edge-tts)	8002	Ses dönüşleri için metin-konuşma
Video (ffmpeg)	8005	Video anlama
SearXNG	8888	`web_search` araç
Chrome/CDP	9222	`browser` / `computer` araçlar

STT, TTS, video, web araması (SearXNG) ve tarayıcı (CloakBrowser), tümü yükleyici tarafından kutudan çıktığı gibi kurulur. Arama ve tarayıcı yükleri, imzalı yükleyici paketinin içinde gelir ve çevrimdışı kurulur: bunları --no-search / --no-browser ile kapatın veya yerel kurulum yerine, zaten çalıştırdığınız bir örneği --external-search=URL / --external-browser=URL ile bağlayın. Ses yan arabalarını AIHUMMER_SKIP_* değişkenleriyle atlayın. Anlamsal gömme öğesi isteğe bağlıdır (--with-embedder): PyTorch’u çeker (yüzlerce MB) ve onsuz bellek sözcüksel aramaya geri döner. Bakınız Kurulum.

[!NOTE] Node.js (sürüm 20 veya daha yenisi) de yükleyici paketinin içinde gelir ve çevrimdışı kurulur; böylece Node.js eklentileri — AiHummer uygulaması, pocket-agent ve kanal bağlayıcıları — kendi Node.js’i çok eski olan dağıtımlarda bile kutudan çıktığı gibi çalışır.

LLM sağlayıcıları

AiHummer hiçbir zaman ücretli bir modele ihtiyaç duymaz. Ücretsiz/yerel modellerde ve bir Codex/ChatGPT abonelik taşımacılığı ile kutudan çıktığı gibi çalışır; her kiracı için BYOK anahtarları tamamen isteğe bağlıdır.

Desteklenen sağlayıcılar:

Antropik.
OpenAI.
Herhangi bir OpenAI-API standardı uç noktası — yerel model sunucuları, OpenRouter veya Örneğin, Gemini’nin OpenAI uyumlu uç noktası.
Codex / ChatGPT-abonelik taşımacılığı — bir modeli ChatGPT üzerinden çalıştırmak faturalı bir API anahtarı yerine abonelik.

[!TIP] Bir model bağlamadan geçidi başlatırsanız (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), yanıtlar deterministik bir kaynaktan gelir alay etmek böylece kanalları doğrulayabilir ve Gerçek bir modele bağlanmadan önce yönlendirme.

[!NOTE] AiHummer yalnızca OpenAI ile uyumlu olanı ortaya çıkarır POST /v1/chat/completions uç nokta. Var hayır /v1/models veya /v1/embeddings HTTP uç noktası ve gözlemlenebilirlik OTLP-push’tur (Prometheus yok /metrics).

Sonra nereye?

Dağıtıma hazır mısınız? Git Kurulum.
İlk koşuyu adım adım yürümek ister misiniz? Bakın Hızlı Başlangıç.
Önce zihinsel modeli mi istiyorsunuz? Oku Giriş.