Kurulum — AiHummer Belgeler

AiHummer yükler ana bilgisayar-tabanlı. Kurulum, kişisel hesabınızda başlar my.aihummer.ru: kaydolursunuz, alırsınız kişisel kurulum linki ve sunucunuzda tek bir komut çalıştırın. Kurulum betiği, mimariniz için imzalı bir paketi indirir, tek bir kurulum kök dizini oluşturur ~/.aihummer (kurulumu çalıştıran kullanıcının ev dizininde), systemd birimlerini kaydeder ve isteğe bağlı olarak yan servisleri sağlar. Bu süreçte hiçbir yerde konteyner yoktur.

[!NOTE] Bu, sistemd altında çalışan bir sürüm arşivi olan host-yerel bir kurulumdur, değil Docker. Ağ geçidi, yan araçlar ve eklentiler her biri kendi systemd’leri olarak çalışır hizmet.

[!NOTE] Başlamadan önce ihtiyacınız olanlar:

a Linux SSH üzerinden erişebileceğiniz sunucu (x86_64 veya arm64);

sudo haklar (veya köksüz kurulum yapma istekliliği — aşağıya bakınız);

PostgreSQL ile pgcrypto uzantı — ya da yükleyicinin sağlamasına izin ver kullanıcı modu kümesi (rootless modda bunu kendisi yapar);

bir hesapta my.aihummer.ru kişisel olanı almak yükleme bağlantısı.

Tam gereksinimler listesi şurada Gereksinimler sayfa.

Adım 1: kişisel kurulum bağlantınızı alın

Kamuya açık bir kurulum betiği yok — kurulum bağlantısı şudur kişisel ve hesap portalınızda verildi:

Kaydol my.aihummer.ru (telefon numarası + şifre; e-posta da gereklidir).
Aç Kurulum ekrana bakın ve “Kişisel yükleme bağlantısını al” seçeneğine tıklayın.
Portal, kişisel bağlantınızla çalıştırmaya hazır bir komut gösterir.

Portalın kendisi hakkında daha fazla bilgi (fatura detayları, belgeler, planlar) şurada bulunabilir Kişisel hesap sayfa.

Adım 2: tek komutla kurulum

Komutu “Kurulum” ekranından kopyalayın ve sunucunuzda (Linux x86_64/arm64) çalıştırın:

curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh

Kişisel bağlantı şöyle görünür https://my.aihummer.ru/dl/<token>/install.sh ve hesabınıza bağlıdır.

[!IMPORTANT] Bağlantı tek kullanımlıktır: tam olarak bir kurulumda çalışır. Kurulum programı install.sh dosyasını onun üzerinden indirdiği anda bağlantı harcanmış sayılır. Aynı komutu yeniden çalıştırırsanız “bağlantı zaten kullanıldı” hatasını alırsınız; bu bir arıza değil, bir korumadır. Ne yapmalı: kişisel hesabınızdaki “Kurulum” ekranını açın ve yeni bir bağlantı üretin; ücretsizdir ve anında olur.

30 gün süresi kurulumu yeniden çalıştırmaya değil, yapıların indirilmesine ilişkindir: kurulmuş bir örnek, bağlantı kuruluma harcandıktan çok sonra da kendi bağlantısı üzerinden güncellenmeye devam eder.

Betik, CPU mimarinizi algılar, uygun paketi ve onunla birlikte olanları indirir .sha256 toplam denetimi ve ortak imzalama .sig imza, her ikisini de doğrular, yükleme kökünü açar ve ağ geçidi hizmetini kaydeder. Bkz. Değişiklik Günlüğü mevcut sürüm için.

Kişisel bağlantı da örneği müşteri portalı hesabınıza bağlar: yükleyici bağlantıdan token’ı saklar, örneklem satıcıyla yaptığı ilk kayıtta bunu gönderir ve portal örneklemi hesabınıza otomatik olarak bağlar. E-posta adresiniz hemen örneklemin doğrulanmış iletişim — Web UI’de ayrı bir “e-posta ekle ve doğrula” adımı yok ve lisans herhangi bir manuel adım olmadan teslim ediliyor.

[!WARNING] Kişisel bağlantınız dağıtımın anahtarıdır. Bunu yayınlamayın: herhangi biri Bağlantıyı tutmak, belirteç süresi dolana kadar sizin adınıza yapı dosyalarını indirebilir.

Kök düzeni yükle

Her şey tek bir dizinin altında durur. Hangisi olacağı, kurulumu nasıl çalıştırdığınıza bağlıdır:

Nasıl kurdunuz	Kurulum kökü	Yapılandırma	Hizmet kimin adına çalışır
Olağan kurulum (`sudo` ile)	`/home/.aihummer`	`/etc/aihummer/gateway.env`	Ayrı bir `aihummer` hizmet hesabı
Root olmadan (rootless)	`~/.aihummer`	`~/.aihummer/etc/gateway.env`	Kendi kullanıcınız

Olağan kurulum dosyaları ev dizininize koymaz ve hizmeti sizin adınıza çalıştırmaz: ayrıcalığı olmayan ayrı bir aihummer hesabı oluşturur. Bu bilinçli bir seçimdir — hizmeti ele geçiren biri yine de kişisel dosyalarınıza erişemez.

Kökün içindeki yerleşim her iki kipte de aynıdır (aşağıda olağan kurulum gösterilmiştir):

/home/.aihummer/
├── bin/        gateway binary and the aihummer CLI
├── etc/        configuration (gateway.env)
├── share/      static assets for the administration interface
├── sidecars/   optional STT/TTS/etc services
├── plugins/    installed marketplace plugins
├── systemd/    unit files (symlinked into /etc/systemd/system)
├── state/      runtime state
├── data/       blob/media storage
└── logs/       service logs

Oluşturulan systemd birim dosyaları systemd/ olmak sembolik olarak bağlandı /etc/systemd/system/, bu nedenle düzenli olarak yönetilirler systemctl komutlar.

Kökten yoksun kurulum

sudo/root ayrıcalıkları gerekli değildir. Eğer yükleme komutunu çalıştırırsanız sudo olmadan, yükleyici rootless moduna geçer: birimler şurada kaydedilir systemd --user kapsam (dosyalar içinde ~/.config/systemd/user), aihummer CLI ve cosign karaya çıkıyor ~/.aihummer/bin, ve eğer AIHUMMER_DATABASE_URL kurulum ayarlanmadığında kurucu, kurulum kökü içinde kullanıcı modunda bir PostgreSQL kümesi sağlar. Servisler ile yönetilir systemctl --user .... Hizmetlerin yalnızca kullanıcı girişinde değil, sunucu açılışında başlamasını sağlamak için, lingering özelliğini etkinleştirin:

loginctl enable-linger $USER

Yan araba seçimi

Hafif medya yan arabaları — STT (faster-whisper), TTS (edge-tts) ve video — kutudan çıkar çıkmaz yükle, sorulmadan veya işaretlenmeden: gidiş-dönüş ses hemen çalışır. Bunlardan herhangi biri ortam değişkenleriyle devre dışı bırakılabilir AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1.

Web araması (SearXNG) ve tarayıcı (CloakBrowser) imzalı pakete gömülüdür ve varsayılan olarak çevrimdışı kurulur — kurulumcu artık bunları sormaz. Bu davranışı bayraklarla değiştirirsiniz — işte tam liste:

Bayrak	Etkisi
`--no-search` / `--no-browser`	Bu yan arabayı atla
`--external-search=URL` / `--external-browser=URL`	Kurmak yerine bu URL’deki mevcut hizmeti kullanın
`--browser-engine=cloak\|chrome`	Tarayıcı motoru (varsayılan `cloak`)
`--with-search` / `--with-browser`	v1.0.14’ten beri gereksiz — bu zaten varsayılan davranıştır
`--with-embedder`	Semantik yerleştiriciyi yükleyin (katılmak: PyTorch’u çeker — yüzlerce MB

Arama ve tarayıcı tty olmadan da kurulur: içerikleri paketten geldiği için bunun için internet erişimi gerekmez. Her iki kurulum da engellemez — içerik yoksa veya Python sürümü desteklenmiyorsa hizmet yalnızca yapılandırılmamış kalır ve kurulum asla iptal edilmez. Gömücü ayrıca ile de etkinleştirilebilir AIHUMMER_WITH_EMBEDDER=1; onsuz hafıza sözcüksel geri dönüş aramasına dayanır. Kullanıcı arayüzü dili tarafından ayarlanır AIHUMMER_LANG=ru|en (aksi takdirde yükleyici bir tty üzerinde sorar). PostgreSQL bağlantısı bir tty üzerinde sorulur; etkileşimli olmayan yüklemeler için ayarlayın AIHUMMER_DATABASE_URL önceden. Bir tty üzerinde yükleyici ayrıca bir yedekten geri yükleme seçeneği sunar.

# Install the gateway with the embedder, without the browser (search is on by default)
curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh \
  --with-embedder --no-browser

Yan arabalar URL ile adreslendiğinden, yerel ve dış yan arabaları özgürce karıştırabilir ve birden fazla geçidi tek bir paylaşılan yan arabaya yönlendirebilirsiniz.

Yapının gerçekliği nasıl doğrulanır

Kişisel hesabınızdaki bağlantı her zaman güncel sürümü kurar; bu, olağan ve tek yoldur. Seçilecek “daha yeni bir sürüm” yoktur: üreticinin gerçek kullanım için yayımladığı yapıyı alırsınız.

Her yapı dosyası — hem ilk kurulumda hem de her güncellemede — mimarinize uygun bir tarball olarak gelir; yanında bir .sha256 sağlama toplamı ve bir .sig (cosign) imzası bulunur. Kurulum programı, herhangi bir şeyi açmadan önce ikisini birden doğrular. Elle doğrulama yapmanız hiç gerekmez.

Beklenen sonuç: doğrulamalar sessizce geçer ve kurulum sürer. Biri tutmazsa kurulum programı bir hatayla durur ve çalışmakta olan sürüme dokunmaz — bozulmuş ya da değiştirilmiş bir dosya sunucunuza hiç ulaşmaz.

Üretici sizi erken deneme programına çağırdıysa kişisel hesabınızdaki “Kurulum” ekranında bir seçim düğmesi görünür ve seçtiğiniz seçenek için ayrı bir bağlantı üretilir — bkz. Örnek.

Kurulumu doğrula

Yükleyici bittikten sonra, servisi ve hazır olma uç noktasını kontrol edin:

systemctl status aihummer-gateway
curl -fsS http://localhost:8780/healthz
curl -fsS http://localhost:8780/readyz

/healthz canlılık ve sürümü raporlar; /readyz PostgreSQL’u kontrol eder ve döndürür 503 veritabanına ulaşılamazken. Paketlenmiş aihummer CLI ayrıca sağlar aihummer status ve aihummer doctor hızlı bir sağlık özeti için.

Başarılı bir kurulumdan sonra görecekleriniz: aihummer-gateway içinde hizmet active (running), bir 200 den /healthz ve /readyz, ve başlangıç yönetici şifresi /home/.aihummer/etc/initial-admin-password.txt (rootless kurulumda ~/.aihummer/etc/initial-admin-password.txt) için ilk giriş.

Üretim kontrol listesi

Tek bir kurulum komutu, ağ geçidini çalıştırır, ancak henüz üretim için hazır değil. Açığa çıkarmadan önce, tamamlayın:

TLS — ağ geçidinin önünde HTTPS sonlandırın (ters proxy / kendi) sertifika); sıradan portu güvenilmeyen bir ağda asla açığa çıkarmayın.
🔴 Ters proxy üzerinde WebSocket desteğini açın. Mobil ve masaüstü uygulaması ağ geçidine wss:// üzerinden bağlanır, bu yüzden proxy Upgrade ve Connection başlıklarını iletmelidir. Bu ayar olmadan proxy, 101 Switching Protocols yerine 200 durumlu sıradan bir sayfa döndürür — uygulama bunu «servis yanıt vermiyor» diye okur, oysa ağ geçidi sorunsuz çalışır ve günlüğünde tek bir hata bile yoktur. Nginx Proxy Manager’da bu, ilgili Proxy Host için Websockets Support anahtarıdır; sıradan nginx’te ise — proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; artı location bloğunda proxy_http_version 1.1.

Tek komutla kontrol (200 değil, 101 beklenir):
```
curl -s -o /dev/null -w '%{http_code}\n' \
  -H 'Connection: Upgrade' -H 'Upgrade: websocket' \
  -H 'Sec-WebSocket-Version: 13' -H 'Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==' \
  https://alan-adiniz/
```
Yönetici şifresini değiştir ve sil initial-admin-password.txt; ayarla kimlik doğrulama sağlayıcısı (AIHUMMER_OIDC_ISSUER / LDAP / SAML) açığa çıkarmadan önce /admin/*.
Ana anahtarın ve veritabanının yedeğini alın — kayıt AIHUMMER_MASTER_KEY (sırlar onsuz geri alınamazlar) ve düzenli PostgreSQL yedeklemeleri ayarlayın.
Gerçek bir modeli kablolayın — set AIHUMMER_LLM_* (veya BYOK); olmadan yanıtlar gelir deterministik sahte olandan.
En az bir kanal bağlayın (Başlamak için Telegram) ve ona bir ajan bağlayın.

Gör İlk giriş, Yapılandırma ve Yedeklemeler ve Felaket Kurtarma detaylar için.

Eğer işe yaramadıysa

“bağlantı zaten kullanıldı” / kurulum ikinci kez başlamıyor — bağlantı tek kullanımlıktır ve önceki bir deneme onu çoktan harcamıştır. Portaldaki “Kurulum” ekranından yenisini alın ve komutu yeniden çalıştırın.
curl: (22) … 404 veya “bağlantı geçersiz” — bağlantı eksik kopyalanmış ya da süresi dolmuş olabilir. Çaresi aynı: yeni bir bağlantı.
desteklenmeyen mimari — kurulum Linux x86_64 ve arm64’u destekliyor; Diğer platformlar için bir paket yok.
/readyz dönüşler 503 — ağ geçidi PostgreSQL’i göremiyor. Kontrol et AIHUMMER_DATABASE_URL, veritabanı erişilebilirliği ve ki pgcrypto uzantı oluşturulur (CREATE EXTENSION IF NOT EXISTS pgcrypto;).
Servis başlamadı — incelemek systemctl status aihummer-gateway ve journalctl -u aihummer-gateway; hızlı bir teşhis için çalıştır aihummer doctor.
Sudo olmadan yüklendi, çıkış yaptıktan sonra servisler duruyor — kalıcılığı etkinleştir: loginctl enable-linger $USER (bakınız kökten yoksun).
İmza doğrulaması başarısız oldu — yüklemeye devam etmeyin; daha sonra tekrar deneyin veya yeni bir bağlantı al. Eser her zaman bununla doğrulanır .sha256 ve koz ve imza .sig.

Sonra nereye?

İlk koşu: gör İlk giriş geri almak başlangıç yönetici şifresi /home/.aihummer/etc/initial-admin-password.txt (rootless kurulumda ~/.aihummer/etc/initial-admin-password.txt).
Dağıtımı ayarla: oku Yapılandırma.
Yönlendirmeli bir ilk koşu ister misiniz? Kullanın Hızlı Başlangıç.