स्थापना — AiHummer डॉक्स

ऐआईहमर इंस्टॉल करता है होस्ट-नेटिव. स्थापना आपके व्यक्तिगत खाते में शुरू होती है my.aihummer.ru: आप पंजीकरण करते हैं, प्राप्त करते हैं व्यक्तिगत इंस्टॉल लिंक और अपने सर्वर पर एक ही कमांड चलाएँ। इंस्टॉल स्क्रिप्ट आपके आर्किटेक्चर के लिए एक साइन किया हुआ बंडल डाउनलोड करती है, और एक ही इंस्टॉल रूट स्थापित करती है ~/.aihummer (उपयोगकर्ता की होम डायरेक्टरी में जिसने इंस्टॉलर चलाया), सिस्टमड यूनिट्स को रजिस्टर करता है, और वैकल्पिक रूप से साइडकार्स प्रोविजन करता है। इस प्रक्रिया में कहीं भी कंटेनर नहीं हैं।

[!NOTE] यह एक होस्ट-नेटिव इंस्टॉल है — सिस्टमड के तहत चलने वाला एक रिलीज़ टारबॉल, नहीं डॉकर। गेटवे, साइडकार और प्लगइन्स प्रत्येक अपने स्वयं के systemd के रूप में चलते हैं सेवा।

[!NOTE] शुरू करने से पहले आपको जिन चीज़ों की ज़रूरत होगी:

एक लिनक्स सर्वर (x86_64 या arm64) जिसे आप SSH के माध्यम से पहुँच सकते हैं;

sudo अधिकार (या बिना रूट स्थापित करने की इच्छा — नीचे देखें);

पोस्टग्रेसक्यूएल के साथ pgcrypto एक्सटेंशन — या इंस्टॉलर को प्रावधान करने दें यूजर-मोड क्लस्टर (रूटलेस मोड में यह यह स्वयं करता है);

एक खाता my.aihummer.ru अपना व्यक्तिगत पाने के लिए स्थापना लिंक।

पूरा आवश्यकताओं की सूची पर है आवश्यकताएँ पृष्ठ।

चरण 1: अपनी व्यक्तिगत इंस्टॉल लिंक प्राप्त करें

कोई सार्वजनिक इंस्टाल स्क्रिप्ट नहीं है — इंस्टाल लिंक है व्यक्तिगत और आपके खाता पोर्टल में जारी किया गया:

पर पंजीकरण करें my.aihummer.ru (फोन नंबर + पासवर्ड; ई-मेल भी आवश्यक है)।
खोलें इंस्टॉलेशन स्क्रीन पर जाएँ और “व्यक्तिगत इंस्टॉलेशन लिंक प्राप्त करें” पर क्लिक करें।
पोर्टल आपके व्यक्तिगत लिंक के साथ एक तैयार-चलाने योग्य कमांड दिखाता है।

पोर्टल के बारे में अधिक जानकारी (बिलिंग विवरण, दस्तावेज़, योजनाएं) यहाँ है व्यक्तिगत खाता पृष्ठ।

चरण 2: एक-कमान्ड इंस्टॉल

कमान्ड को “इंस्टॉलेशन” स्क्रीन से कॉपी करें और इसे अपने सर्वर (Linux x86_64/arm64) पर चलाएँ:

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

व्यक्तिगत लिंक का रूप https://my.aihummer.ru/dl/<token>/install.sh होता है और वह आपके खाते से जुड़ा रहता है।

[!IMPORTANT] यह लिंक एक ही बार काम आता है: ठीक एक स्थापना के लिए। जैसे ही इंस्टॉलर ने इसके ज़रिये install.sh उतार लिया, लिंक खर्च हुआ मान लिया जाता है। वही आदेश दोबारा चलाने पर «लिंक पहले ही इस्तेमाल हो चुका है» त्रुटि मिलती है — यह खराबी नहीं, बचाव है। क्या करें: पोर्टल में «स्थापना» स्क्रीन खोलिए और नया लिंक बनाइए; यह मुफ़्त और तत्काल है।

30 दिन की अवधि आर्टिफैक्ट उतारने पर लागू होती है, दोबारा स्थापना पर नहीं: पहले से स्थापित इंस्टेंस अपने लिंक के ज़रिये अपडेट पाता रहता है, भले ही वह लिंक स्थापना पर बहुत पहले खर्च हो चुका हो।

स्क्रिप्ट आपके CPU आर्किटेक्चर का पता लगाती है, और उसके साथ मेल खाने वाला बंडल डाउनलोड करती है .sha256 चेकसाम और कोसाइन .sig हस्ताक्षर, दोनों को सत्यापित करता है, इंस्टॉल रूट को अनपैक करता है और गेटवे सेवा को पंजीकृत करता है। देखें चेंजलॉग वर्तमान संस्करण के लिए।

व्यक्तिगत लिंक भी इंस्टेंस को आपके ग्राहक पोर्टल खाते से जोड़ता है: इंस्टॉलर लिंक से टोकन संग्रहीत करता है, इंस्टेंस इसे अपने पहले पंजीकरण के समय विक्रेता को भेजता है, और पोर्टल अपने आप इंस्टेंस को आपके खाते से जोड़ देता है। आपका ई-मेल तुरंत इंस्टेंस का बन जाता है सत्यापित संपर्क — वेब यूआई में कोई अलग ‘ई-मेल संलग्न करें और सत्यापित करें’ कदम नहीं है, और लाइसेंस बिना किसी मैनुअल स्टेप के दिया जाता है।

[!WARNING] आपका व्यक्तिगत लिंक वितरण की कुंजी है। इसे प्रकाशित न करें: कोई भी लिंक को पकड़ने से आप के टोकन की समयसीमा समाप्त होने तक आपके बजाय बिल्ड डाउनलोड कर सकता है।

रूट लेआउट स्थापित करें

सब कुछ एक ही डायरेक्टरी के अंतर्गत रहता है। वह कौन-सी होगी, यह इस पर निर्भर है कि आपने इंस्टॉलर किस तरह चलाया:

स्थापना का तरीका	स्थापना मूल	कॉन्फ़िगरेशन	सेवा किसके रूप में चलती है
सामान्य स्थापना (`sudo` के साथ)	`/home/.aihummer`	`/etc/aihummer/gateway.env`	एक समर्पित सेवा खाता `aihummer`
root के बिना (rootless)	`~/.aihummer`	`~/.aihummer/etc/gateway.env`	आपका अपना उपयोगकर्ता

सामान्य स्थापना आपकी होम डायरेक्टरी में फ़ाइलें नहीं रखती और सेवा को आपकी पहचान से नहीं चलाती: वह एक समर्पित, बिना विशेषाधिकार वाला उपयोगकर्ता aihummer बनाती है। यह जानबूझकर किया गया है — सेवा से छेड़छाड़ हो जाने पर भी हमलावर के हाथ आपकी निजी फ़ाइलें नहीं लगतीं।

मूल के भीतर की संरचना दोनों तरीकों में एक जैसी रहती है (नीचे सामान्य स्थापना दिखाई गई है):

/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

सिस्टमड यूनिट फाइलें जो उत्पन्न हुईं systemd/ हैं सिम्लिंक किया गया /etc/systemd/system/, इसलिए उन्हें नियमित रूप से प्रबंधित किया जाता है systemctl आदेश।

रूटलेस इंस्टाल

sudo/रूट विशेषाधिकार आवश्यक नहीं हैं। यदि आप इंस्टॉल कमांड चलाते हैं सूडो के बिना, इंस्टॉलेटर रूटलेस मोड में बदल जाता है: यूनिट्स पंजीकृत किए जाते हैं systemd --user स्कोप (फ़ाइलें में ~/.config/systemd/user), वह aihummer CLI और cosign लैंड में ~/.aihummer/binऔर अगर AIHUMMER_DATABASE_URL सेट नहीं है, इंस्टॉलर इंस्टॉल रूट के अंदर एक उपयोगकर्ता-मो्ड PostgreSQL क्लस्टर तैयार करता है। सेवाओं का प्रबंधन किया जाता है systemctl --user ...होस्ट बूट पर सेवाओं को शुरू करने के लिए (केवल उपयोगकर्ता लॉगिन पर नहीं), लिंगरिंग सक्षम करें:

loginctl enable-linger $USER

साइडकार चयन

हल्के मीडिया साइडकार — STT (फास्टर-व्हिस्पर), TTS (एज-टीटीएस) और वीडियो — बॉक्स से बाहर इंस्टॉल करें, बिना किसी सवाल या चेतावनी के: राउंड-ट्रिप वॉइस तुरंत काम करती है। इन्हें किसी भी समय वातावरण चर से अक्षम किया जा सकता है। AIHUMMER_SKIP_STT=1, AIHUMMER_SKIP_TTS=1, AIHUMMER_SKIP_VIDEO=1.

वेब खोज (SearXNG) और ब्राउज़र (CloakBrowser) हस्ताक्षरित बंडल में अंतर्निहित हैं और डिफ़ॉल्ट रूप से ऑफ़लाइन इंस्टॉल होते हैं — इंस्टॉलर अब इनके बारे में नहीं पूछता। फ़्लैग्स इस व्यवहार को बदल देते हैं — यह पूरी सूची है:

झंडा	प्रभाव
`--no-search` / `--no-browser`	इस साइडकार को छोड़ें
`--external-search=URL` / `--external-browser=URL`	इंस्टॉल करने के बजाय इस URL पर मौजूदा सेवा का उपयोग करें
`--browser-engine=cloak\|chrome`	ब्राउज़र इंजन (डिफ़ॉल्ट `cloak`)
`--with-search` / `--with-browser`	v1.0.14 से अनावश्यक — यही पहले से डिफ़ॉल्ट व्यवहार है
`--with-embedder`	सामांतिक एम्बेडर इंस्टॉल करें (सहमति देना: PyTorch खींचता है — सैकड़ों MB)

खोज और ब्राउज़र tty के बिना भी इंस्टॉल होते हैं: उनकी सामग्री बंडल से आती है, इसके लिए इंटरनेट एक्सेस की ज़रूरत नहीं। दोनों की इंस्टॉलेशन अवरोधक नहीं है — सामग्री न मिलने या Python संस्करण असमर्थित होने पर सेवा बस अविन्यस्त रह जाती है और इंस्टॉलेशन कभी नहीं रुकती। एम्बेडर को भी सक्षम किया जा सकता है AIHUMMER_WITH_EMBEDDER=1; इसके बिना मेमोरी लेक्सिकल फ़ॉलबैक खोज पर चलती है। UI भाषा सेट की जाती है AIHUMMER_LANG=ru|en (अन्यथा इंस्टॉलर tty पर पूछता है)। PostgreSQL कनेक्शन tty पर पूछा जाता है; गैर-इंटरैक्टिव इंस्टॉलेशन के लिए सेट करें AIHUMMER_DATABASE_URL पहले से। एक टीटीवाई पर इंस्टालर बैकअप से पुनर्स्थापना की सुविधा भी देता है।

# गेटवे को एम्बेडर के साथ इंस्टॉल करें, ब्राउज़र के बिना (खोज डिफ़ॉल्ट रूप से इंस्टॉल होती है)
curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh \
  --with-embedder --no-browser

क्योंकि साइडकार को URL द्वारा संबोधित किया जाता है, आप स्वतंत्र रूप से मूल और बाहरी दोनों को मिला सकते हैं और कई गेटवे को एक साझा साइडकार पर इंगित कर सकते हैं।

बिल्ड की प्रामाणिकता कैसे जाँची जाती है

आपके खाता पोर्टल का व्यक्तिगत लिंक हमेशा मौजूदा रिलीज़ ही स्थापित करता है — यही मानक और एकमात्र रास्ता है। चुनने के लिए कोई «और नया संस्करण» होता ही नहीं: आपको वही बिल्ड मिलता है जिसे विक्रेता ने उत्पादन उपयोग के लिए जारी किया है।

हर आर्टिफैक्ट — पहली स्थापना पर भी और हर अपडेट पर भी — आपकी वास्तुकला के लिए टारबॉल के रूप में आता है, जिसके साथ .sha256 चेकसम और .sig (cosign) हस्ताक्षर होते हैं। कुछ भी खोलने से पहले इंस्टॉलर दोनों की जाँच करता है। आपको हाथ से कुछ भी जाँचने की ज़रूरत नहीं।

अपेक्षित परिणाम: जाँच चुपचाप पूरी होती है और स्थापना आगे बढ़ती है। इनमें से कोई एक भी न मिले, तो इंस्टॉलर त्रुटि के साथ रुक जाता है और चल रहे संस्करण को अछूता छोड़ देता है — क्षतिग्रस्त या बदली हुई फ़ाइल आपके सर्वर तक कभी नहीं पहुँचती।

विक्रेता ने यदि आपको प्रारंभिक-परीक्षण कार्यक्रम में बुलाया है, तो पोर्टल की «स्थापना» स्क्रीन पर एक स्विच दिखता है और आपके चुने विकल्प के लिए अलग लिंक जारी होता है — देखें इंस्टेंस।

स्थापना की पुष्टि करें

इंस्टॉलर समाप्त होने के बाद, सेवा और तैयारी एंडपॉइंट की जाँच करें:

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

/healthz सक्रियता और संस्करण की रिपोर्ट करता है; /readyz पोस्टग्रेसक्यूएल की जाँच करता है और लौटाता है 503 जब डेटाबेस पहुंच योग्य नहीं होता। बंडल किया गया aihummer CLI भी प्रदान करता है aihummer status और aihummer doctor सुरक्षित स्वास्थ्य अवलोकन के लिए।

सफल स्थापना के बाद आप जो देखेंगे: का aihummer-gateway सेवा में active (running), एक 200 से /healthz और /readyz, और प्रारंभिक व्यवस्थापक पासवर्ड में /home/.aihummer/etc/initial-admin-password.txt (रूटलेस स्थापना में ~/.aihummer/etc/initial-admin-password.txt) के लिए पहली बार लॉगिन.

उत्पादन चेकलिस्ट

एक ही इंस्टॉल कमांड गेटवे को चलाने के लिए पर्याप्त है, लेकिन यह अभी उत्पादन के लिए तैयार नहीं. इसे उजागर करने से पहले, पूरा करें:

टीएलएस — गेटवे के सामने HTTPS समाप्त करें (रिवर्स प्रॉक्सी / आपका खुद का) सर्टिफिकेट); कभी भी अप्रत्याशित नेटवर्क पर सामान्य पोर्ट को उजागर न करें।
🔴 रिवर्स प्रॉक्सी पर WebSocket समर्थन चालू करें। मोबाइल और डेस्कटॉप ऐप गेटवे से wss:// के ज़रिए जुड़ता है, इसलिए प्रॉक्सी को Upgrade और Connection हेडर आगे भेजने चाहिए। इस सेटिंग के बिना प्रॉक्सी 101 Switching Protocols के बजाय स्थिति 200 वाला सामान्य पेज लौटाता है — ऐप इसे «सेवा जवाब नहीं दे रही» के रूप में पढ़ता है, जबकि गेटवे ठीक चल रहा होता है और उसके लॉग में एक भी त्रुटि नहीं होती। Nginx Proxy Manager में यह संबंधित Proxy Host का स्विच Websockets Support है, सामान्य nginx में — proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; और location ब्लॉक में proxy_http_version 1.1।

एक कमांड से जाँच (200 नहीं, 101 अपेक्षित है):
```
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://आपका-डोमेन/
```
एडमिन पासवर्ड बदलें और मिटाएँ initial-admin-password.txt; सेट करें प्रमाणीकरण जारीकर्ता (AIHUMMER_OIDC_ISSUER / LDAP / SAML) को उजागर करने से पहले /admin/*.
मास्टर की और डेटाबेस का बैकअप लें — रिकॉर्ड AIHUMMER_MASTER_KEY (रहस्य इसके बिना पुनःप्राप्त नहीं किए जा सकते) और नियमित PostgreSQL बैकअप सेट करें।
एक असली मॉडल वायर करें — सेट AIHUMMER_LLM_* (या BYOK); इसके बिना उत्तर आते हैं निर्धारित मॉक से।
कम से कम एक चैनल कनेक्ट करें (टेलीग्राम शुरू करने के लिए) और इसके लिए एक एजेंट को बंधित करें।

देखो पहली बार लॉगिन, कॉन्फ़िगरेशन और बैकअप और आपदा पुनर्प्राप्ति विवरण के लिए।

अगर यह काम नहीं किया

«लिंक पहले ही इस्तेमाल हो चुका है» / स्थापना दूसरी बार नहीं चलती — लिंक एक ही बार काम आता है और पिछली कोशिश उसे खर्च कर चुकी है। पोर्टल की “इंस्टॉलेशन” स्क्रीन पर नया लिंक बनाइए और आदेश फिर से चलाइए।
curl: (22) … 404 या “लिंक अमान्य” — लिंक अधूरा नकल हुआ था या उसकी अवधि बीत चुकी है। उपाय वही है: एक नया लिंक।
असमर्थित वास्तुकला — इंस्टॉलेशन Linux x86_64 और arm64 का समर्थन करता है; अन्य प्लेटफार्मों के लिए कोई बंडल नहीं है।
/readyz लौटाता है 503 — गेटवे PostgreSQL को नहीं देख पा रहा है। जांचें AIHUMMER_DATABASE_URL, डेटाबेस पहुंच, और कि pgcrypto एक्सटेंशन बनाया गया (CREATE EXTENSION IF NOT EXISTS pgcrypto;).
सेवा शुरू नहीं हुई — निरीक्षण करें systemctl status aihummer-gateway और journalctl -u aihummer-gateway; एक त्वरित निदान चलाने के लिए aihummer doctor.
sudo के बिना इंस्टॉल किया गया, लॉगआउट के बाद सेवाएं बंद हो जाती हैं — लंबित रखने को सक्षम करें: loginctl enable-linger $USER (देखें बेरूट).
हस्ताक्षर सत्यापन विफल हुआ — इंस्टॉल के साथ आगे मत बढ़ें; बाद में पुनः प्रयास करें या नया लिंक प्राप्त करें। कलाकृति हमेशा इसके खिलाफ सत्यापित की जाती है .sha256 और सह-हस्ताक्षर करना .sig.

अगला कहाँ

पहली बार चलाएँ: देखें पहली बार लॉगिन प्राप्त करना प्रारंभिक व्यवस्थापक पासवर्ड से /home/.aihummer/etc/initial-admin-password.txt (रूटलेस स्थापना में ~/.aihummer/etc/initial-admin-password.txt).
परिनियोजन को समायोजित करें: पढ़ें कॉन्फ़िगरेशन.
क्या आप पहला रन गाइड के साथ करना चाहते हैं? उपयोग करें त्वरित शुरुआत.