साइडकार
कुछ क्षमताएँ — भाषण, वीडियो, वेब खोज, एक हेडलेस ब्राउज़र — स्वयं गेटवे का हिस्सा नहीं हैं। वे इस रूप में चलते हैं साइडकार: छोटे, स्वतंत्र HTTP सेवाएँ जो गेटवे तक पहुँचती हैं यूआरएल द्वारा. हर साइडकार है मुफ्त और स्थानीय: इनके पीछे कोई अनिवार्य पेड API नहीं है।
साइडकार क्या होता है
साइडकार एक अलग प्रक्रिया है जो एक HTTP API को प्रदर्शित करती है। गेटवे इसे कभी लिंक या इन-प्रोसेस नहीं चलाता — यह केवल उस URL को कॉल करता है जिसे आप कॉन्फ़िगर करते हैं। प्रत्येक साइडकार
- के तहत चलता है अपना खुद का systemd यूनिट (होस्ट-नेटिव, कोई कंटेनर नहीं),
- एक पर्यावरण चर के माध्यम से गेटवे से जुड़ा हुआ है, और
- सकता है गेटवे के बगल में मूल रूप से स्थापित किया गया, या किसी मौजूदा पर इंगित किया गया उदाहरण तुम पहले ही कहीं और भाग चुके हो।
क्योंकि अनुबंध केवल HTTP है, वही कॉन्फ़िगरेशन काम करता है चाहे साइडकार चालू हो या न हो localhost या किसी अन्य होस्ट पर।
[!NOTE] साइडकार वैकल्पिक हैं — एक अपवाद के साथ: वेब खोज (SearXNG) और एंटी-डिटेक्ट ब्राउज़र (CloakBrowser) बॉक्स से बाहर इंस्टॉल होते हैं। उनके पेलोड हस्ताक्षरित इंस्टॉलर बंडल के अंदर आते हैं और ऑफ़लाइन इंस्टॉल होते हैं। उन्हें इंस्टॉलर फ़्लैग
--no-searchऔर--no-browserसे बंद करें। बाकी हर क्षमता केवल तभी सक्रिय होती है जब उसका URL कॉन्फ़िगर किया गया हो; न्यूनतम इंस्टाल अब भी सिर्फ गेटवे प्लस PostgreSQL है।
साइडकार और उनके पोर्ट
| बंदरगाह | साइडकार | के द्वारा समर्थित | शक्तियाँ | वायर से जुड़ा हुआ |
|---|---|---|---|---|
| 8001 | एसटीटी | फास्ट-व्हिस्पर | वाणी से पाठ | AIHUMMER_STT_URL |
| 8002 | टीटीएस | एज-टीटीएस | पाठ-से-भाषण | AIHUMMER_TTS_URL |
| 8005 | वीडियो | एफएफएमपीईजी | वीडियो समझ | AIHUMMER_VIDEO_URL |
| 8888 | SearXNG | SearXNG | का web_search उपकरण |
इंस्टॉलर द्वारा इंस्टॉल, सेटिंग छिपी हुई; बाहरी इंस्टेंस — --external-search=URL |
| 9222 | क्रोम / सीडीपी | क्रोम (सीडीपी) | का browser उपकरण |
इंस्टॉलर द्वारा इंस्टॉल, सेटिंग छिपी हुई; बाहरी इंस्टेंस — --external-browser=URL |
वॉइस साइडकार पहले से उपलब्ध मार्ग हैं: STT (:8001) एजेंट टर्न को इनपुट देता है और TTS (:8002) उत्तर सुनाता है; दोनों मुफ़्त स्थानीय इंजनों पर चलते हैं। वीडियो समझ (:8005) एक अतिरिक्त, वैकल्पिक साइडकार है। SearXNG (:8888) web_search को आधार देता है और Chrome/CDP एंडपॉइंट (:9222) browser उपकरण को।
साइडकार वायरिंग
आप गेटवे को प्रत्येक साइडकार की ओर मिलान के साथ इंगित करते हैं कैटलॉग सेटिंग — व्यवस्थापक UI से (प्रबंधन → सेटिंग्स) या के साथ aihummer settings set. gateway.env यह केवल बूटस्ट्रैप-के लिए है और इन कुंजियों के लिए अनदेखा किया जाता है। होस्ट-नेटिव इंस्टाल के लिए वॉइस साइडकार्स (STT/TTS) आपके लिए कॉन्फ़िगर किए जाते हैं; वेब खोज और ब्राउज़र को इंस्टॉलर स्वयं जोड़ता है — आप उनके पते कभी सेट नहीं करते और वे सेटिंग्स में नहीं दिखते; बाकी आप आवश्यकता अनुसार सक्षम करते हैं।
# Voice in/out (auto-configured by the installer for STT/TTS)
aihummer settings set AIHUMMER_STT_URL http://127.0.0.1:8001
aihummer settings set AIHUMMER_TTS_URL http://127.0.0.1:8002
# Optional video sidecar
aihummer settings set AIHUMMER_VIDEO_URL http://127.0.0.1:8005[!TIP] क्योंकि प्रत्येक साइडकार सिर्फ एक URL है, आप भारी सेवाओं को केंद्रीकृत कर सकते हैं। प्रति होस्ट एक प्रति चलाने के बजाय कई गेटवे को एक साझा STT/TTS इंस्टेंस की ओर इंगित करें; खोज और ब्राउज़र के लिए इंस्टॉलर फ़्लैग
--external-search=URLऔर--external-browser=URLयही काम करते हैं।
उन्हें मूल रूप से या साझा रूप से चलाना
प्रत्येक साइडकार अपने होस्ट पर अपने स्वयं के systemd यूनिट के तहत चलता है, इसलिए आप इसे किसी अन्य सेवा की तरह संचालित करते हैं — स्वतंत्र रूप से शुरू, रोकें और लॉग पढ़ें। यदि आप पहले से ही, मान लें, SearXNG या Chrome/CDP एंडपॉइंट चला रहे हैं, तो इंस्टॉलर को --external-search=URL या --external-browser=URL पास करें: कोई स्थानीय प्रति इंस्टॉल नहीं होती और गेटवे इसके बजाय आपके इंस्टेंस को कॉल करता है। आवाज़ और वीडियो के लिए, संबंधित सेटिंग को मौजूदा इंस्टेंस की ओर इंगित करें। किसी भी तरह, गेटवे का दृश्य एक जैसा है: एक कॉन्फ़िगर किया गया URL जिसे वह कॉल कर सकता है।
[!WARNING] द
browser(सीडीपी) औरweb_searchउपकरण नेटवर्क तक पहुँचते हैं। चालू कठोर या एयर-गैप्ड तैनाती में निकासी और एयर-गैप्ड सेटिंग की समीक्षा करें उन्हें सक्षम करने से पहले — गेटवे केवल उस साइडकार को कॉल करता है जिसे आपने जोड़ा है।
अगला कहाँ
- किस प्रकार आवाज़ और ब्राउज़र टूल का उपयोग एक टर्न में किया जाता है: गेटवे और टर्न इंजन.
- न्यूनतम सख्त निर्भरता (PostgreSQL) और बाकी सब कुछ ऐच्छिक: गेटवे और टर्न इंजन.