त्वरित शुरुआत — AiHummer डॉक्स

यह त्वरित आरंभ आपको आपके पहले AiHummer रन के माध्यम से ले जाता है — शून्य से लेकर पहले एजेंट के चैनल में उत्तर देने तक। यह उनके लिए लिखा गया है जो इसे कर रहे हैं पहली बार: हर कदम समाप्त होता है आपको क्या देखना चाहिए, और अंत में एक “अगर यह काम नहीं किया” अनुभाग है।

सबसे पहले, अपनी राह चुनें

AiHummer पाने के दो तरीके हैं (पूरी तुलना में परिचय):

बादल — हम सर्वर चलाते हैं, आप तैयार पता पाएंगे। कुछ भी इंस्टॉल करने की जरूरत नहीं। → जाना पथ A: बादल.
स्वयं-होस्टेड (आपका अपना सर्वर) — आप अपने लिनक्स सर्वर पर AiHummer इंस्टॉल करते हैं एक कमांड के साथ। → जाने के लिए पथ B: आपका अपना सर्वर.

दोनों रास्ते फिर साझा चरणों पर मिलते हैं — पहला एजेंट और पहला चैनल.

पथ A: बादल

आपको जिन चीज़ों की आवश्यकता होगी: एक ई-मेल पता, एक फोन नंबर और एक बैंक कार्ड (परीक्षण के लिए बैंक ₽1 चार्ज करता है और इसे तुरंत वापस कर देता है)।

पर पंजीकरण करें my.aihummer.ru: अपना ईमेल, फोन दर्ज करें और पासवर्ड, दो सहमति स्वीकार करें। आप देखेंगे खाता-सत्यापन स्क्रीन।
खाते की पुष्टि करें — कॉल द्वारा (आगामी नंबर के अंतिम अंक दर्ज करें) या ई-मेल से कोड के साथ। आप पाएंगे कि साइन-इन स्वतः ही हो गया। और ऑनबोर्डिंग विज़ार्ड खुला। विवरण: पंजीकरण और साइन-इन.
विज़ार्ड में क्लाउड मार्ग चुनें, फिर एक योजना (मासिक/सालाना)। प्रवेश योजना के साथ आता है 10-दिन की मुफ्त परीक्षण अवधि. विवरण: योजनाएँ.
अपना भरें बिलिंग विवरण (व्यक्ति या कंपनी/एकल स्वामी) — वे चालान और अधिनियम के लिए आवश्यक हैं।
चुनें एक सबडोमेन नाम (आपका पता होगा <name>.cloud.aihummer.ru) और भुगतान करना. आप देखेंगे कि “आपके सहायक को तैयार किया जा रहा है” स्थिति प्रगति के साथ। विवरण: ऑर्डर और भुगतान.
प्राविज़निंग का इंतजार करें (सामान्यतः कुछ मिनट)। जब स्थिति बदल जाती है आपका सहायक चल रहा है, क्लिक पैनल खोलें — आपके वेब एडमिन UI का इंस्टेंस खुलता है। विवरण: इंस्टेंस डैशबोर्ड.

कॉन्फ़िगरेशन वेब एडमिन UI में जारी है — अपने पर जाएँ पहला एजेंटक्लाउड इंस्टेंस के लिए एडमिन पासवर्ड तब सेट किया जाता है जब आप पहली बार पैनल खोलते हैं (यहाँ सेल्फ-होस्टेड में इस्तेमाल होने वाली अलग पासवर्ड फाइल की जरूरत नहीं है)।

पथ B: आपका अपना सर्वर

आपको जिन चीज़ों की आवश्यकता होगी: एक लिनक्स सर्वर (x86_64 या arm64), sudo अधिकार, और PostgreSQL (या इंस्टॉलर को इसे प्रोविजन करने दें)। पूरी सूची: आवश्यकताएँ.

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

कोई सार्वजनिक इंस्टॉल स्क्रिप्ट नहीं है — लिंक है व्यक्तिगत. पर पंजीकरण करें my.aihummer.ru, खोलें इंस्टॉल स्क्रीन पर जाएं और “Get my personal install link” पर क्लिक करें। आप देखेंगे कि एक तैयार कमांड है जिसमें कॉपी बटन है।

चरण 2. एक कमांड के साथ इंस्टॉल करें

कॉपी किए गए कमांड को सर्वर पर चलाएँ:

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

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

चरण 3. PostgreSQL की ओर इशारा करें

केवल कठोर निर्भरता PostgreSQL के साथ है pgcrypto एक्सटेंशन। इंस्टॉलर आपके लिए कनेक्शन को जोड़ देता है; डेटाबेस को मैन्युअली सेट करने के लिए, उपयोग करें AIHUMMER_DATABASE_URL कॉन्फ़िग विकल्प:

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable

-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;

डेटाबेस माइग्रेशन स्टार्टअप पर स्वतः लागू होते हैं।

चरण 4। सबसे पहले लॉगिन करें

सेवा चालू होने के बाद, सर्वर पर एडमिन वेब UI खोलें (प्राइवेट पोर्ट) :8781 डिफ़ॉल्ट रूप से):

http://localhost:8781/

खाली डेटाबेस पर एक लॉगिन admin सृजित किया जाता है और प्रारंभिक पासवर्ड लिखा जाता है ~/.aihummer/etc/initial-admin-password.txtइसे पढ़ें, साइन इन करें, फिर पासवर्ड बदलें और फ़ाइल तुरंत हटा दें — कदम दर कदम अंदर पहली बार लॉगिन.

चरण: अपना पहला एजेंट बनाएं

यह चरण क्लाउड और स्व-होस्टेड द्वारा साझा किया गया है। वेब एडमिन UI में खोलें एजेंट्स → “+ बनाएँ”, एक नाम सेट करें, एक व्यक्तित्व (सिस्टम प्रॉम्प्ट) और, वैकल्पिक रूप से, एक समर्पित मॉडल। आप देखेंगे नया एजेंट सूची में एक टाइल के रूप में। पूरी जानकारी, पात्र और व्यवहार समायोजन के साथ: एजेंट्स.

चरण: अपने पहले चैनल को कनेक्ट करें

AiHummer तक संदेश पहुँचाने के लिए, एक चैनल जोड़ें:

टेलीग्राम — सबसे उत्पादन-तैयार कनेक्टर; एक अंत-से-अंत तक का वॉकथ्रू “BotFather से पहला संदेश तक” में है टेलीग्राम.
वेब यूआई में सत्र — एक एजेंट को कनेक्ट करने से पहले परीक्षण करने का सबसे तेज़ तरीका बाहरी चैनल।
मैक्स — एक रूसी संदेशवाहक, जो भी उपलब्ध है।

कनेक्टर पर स्थापित किया गया है प्लगइन्स/मार्केटप्लेस स्क्रीन, फिर पर कॉन्फ़िगर किया गया चैनल स्क्रीन, जहां बाइंडिंग्स ब्लॉक सेट करते हैं कि कौन सा एजेंट वह चैनल चलाता है। चैनल पर एक संदेश भेजें और देखें कि एक टर्न क्रमशः शुरू से अंत तक कैसे चलता है।

एडमिन यूआई से सीधे एजेंट से बात करें

पहले परीक्षण के लिए किसी चैनल की आवश्यकता नहीं है: पर सत्र पृष्ठ पर “New session” बटन एडमिन UI के अंदर ही एजेंट के साथ चैट खोलता है। कंपोज़र में आप फ़ाइलें संलग्न करें (छवियाँ और दस्तावेज़ — मॉडल प्राप्त किए गए टेक्स्ट को प्राप्त करता है), और थ्रेड के ऊपर दो टॉगल प्रदर्शित होते हैं प्रति-चरण लागत और उपकरण उत्पादन — यह देखने के लिए सुविधाजनक कि एजेंट ने हर कदम पर क्या किया।

[!TIP] आप सीधे इसके OpenAI-संगत API के माध्यम से AiHummer को भी कॉल कर सकते हैं बिना किसी किसी भी चैनल:
POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}
सेट "stream": true SSE स्ट्रीमिंग के लिए।

मॉख मॉडल को याद रखें

जब तक आप एक असली मॉडल से कनेक्ट नहीं करते, उत्तर एक से आते हैं निर्धारित नकली — चैनलों, रूटिंग और एजेंट्स का परीक्षण करने के लिए सुविधाजनक, बिना किसी मॉडल लागत के। एक वास्तविक प्रदाता (OpenAI, Anthropic, YandexGPT, GigaChat, Codex को ChatGPT सब्सक्रिप्शन के माध्यम से और अधिक) से कैसे कनेक्ट करें, इस पर मॉडल्स पृष्ठ।

[!NOTE] एक असली मॉडल कभी भी अनिवार्य नहीं होता: AiHummer मुफ्त/स्थानीय पर चलता है OpenAI-अनुकूल एंडपॉइंट और एक Codex/ChatGPT-सदस्यता ट्रांसपोर्ट।

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

इंस्टॉल कमांड असफल हो गया — जांचें कि आप इसे Linux x86_64/arm64 पर चला रहे हैं और कि व्यक्तिगत लिंक पुराना न हो (यह 30 दिनों तक रहता है; इसका एक नया लिंक प्राप्त करें “इंस्टॉल” स्क्रीन)। डायग्नोस्टिक्स: स्थापना.
एडमिन UI नहीं खुलेगा — वेब यूआई निजी पोर्ट पर सुनता है :8781, सार्वजनिक नहीं :8780. सेवा जांचें: systemctl status aihummer-gateway.
प्रारंभिक पासवर्ड नहीं मिल रहा — यह में है ~/.aihummer/etc/initial-admin-password.txt, लॉग में नहीं। देखें पहली बार लॉगिन.
क्लाउड भुगतान विफल हो गया — डैशबोर्ड पर सदस्यता स्थिति दिखाती है कारण; पुनः प्रयास करें, या (कंपनियों के लिए) चालान-द्वारा भुगतान चुनें, देखें ऑर्डर और भुगतान.
एजेंट चैनल में जवाब नहीं देता — सुनिश्चित करें कि चैनल किसी से जुड़ा हुआ है एजेंट “बाइंडिंग्स” ब्लॉक में, और यह कि प्रेषक सिस्टम के लिए जाना हुआ है (के द्वारा डिफ़ॉल्ट रूप से एजेंट केवल ज्ञात उपयोगकर्ताओं का जवाब देता है), देखें चैनल.

अगला कहाँ

प्रोडक्शन स्व-होस्टेड डिप्लॉयमेंट: स्थापना.
UI से व्यवहार समायोजित करें: कॉन्फ़िगरेशन.
पहली लॉगिन सुरक्षित करें: पहली बार लॉगिन.
एक मॉडल से कनेक्ट करें: मॉडल्स.