पर्यावरण चर
AIHUMMER_PUBLIC_TLS_CERT_FILE + AIHUMMER_PUBLIC_TLS_KEY_FILE: HTTPS गेटवे स्वयं प्रमाणपत्र/निजी कुंजी की जोड़ी से या आपका रिवर्स प्रॉक्सी दे सकता है। गलत कॉन्फ़िगर की गई जोड़ी पर साधारण HTTP में वापसी नहीं होती। ऐप में निजी प्रमाणपत्र स्वीकार करने से पहले SHA-256 फ़िंगरप्रिंट को विश्वसनीय स्थापना टर्मिनल से मिलाएँ।
AiHummer कॉन्फ़िगरेशन में विभाजित होता है दो पूरी तरह से अलग समूह:
- बूटस्ट्रैप (
gateway.env) — गेटवे को क्या जानना चाहिए पहले यह कर सकता है डेटाबेस पढ़ें: डेटाबेस DSN, सुनने वाले पते, स्थिर निर्देशिकाएँ, मुख्य कुंजी। केवल ये कुंजियाँ पर्यावरण से पढ़ी जाती हैं। - सेटिंग्स कैटलॉग (डेटाबेस) — हर दूसरे नॉब। इन्हें इसमें संग्रहित किया गया है
डेटाबेस और वेब एडमिन UI में सेट करें (प्रबंधन → सेटिंग्स) या के साथ
aihummer settings set <KEY> <VALUE>. इसके लिए चाबियाँ एकgateway.envमान है जानबूझकर अनदेखा किया — भले ही सेट किया गया हो, इसमें कोई प्रभाव नहीं।
कॉन्फ़िगरेशन मॉडल
gateway.env है सिर्फ़ बूटस्ट्रैप. प्रस्ताव आदेश:
- सेटिंग्स-कैटलॉग कुंजी:
database value → built-in default(पर्यावरण की अनदेखी की जाती है); - बूटस्ट्रैप कुंजी:
environment variable only.
तो ट्यून करने योग्य नॉब्स के लिए सच्चाई का एकमात्र स्रोत डेटाबेस है (वेब एडमिन UI / aihummer settings); वातावरण केवल वही रखता है जो प्रक्रिया को शुरू करने के लिए आवश्यक है।
होस्ट-नेटिव इंस्टॉल के लिए कॉन्फ़िग फ़ाइल इस स्थान पर रहती है:
# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes
[!TIP] सेटिंग्स-कैटलॉग के नॉब्स न डालें
gateway.env— इसका कोई असर नहीं होता। बदलें उन्हें वेब एडमिन यूआई में (प्रबंधन → सेटिंग्स, इसमें खोज है) या इसके माध्यम सेaihummer settings set. कुछ परिवर्तन (जैसे टूल टॉगल और उप-एजेंट गहराई) गर्म लागू करें; अन्य को सेवा पुनःआरंभ करने की आवश्यकता होती है।
बूटस्ट्रैप (गेटवे.env)
सिर्फ वही कुंजी जिसे गेटवे वास्तव में पर्यावरण से पढ़ता है।
कोर और डेटाबेस
| चर | उद्देश्य |
|---|---|
AIHUMMER_DATABASE_URL |
अनिवार्य। पोस्टग्रेएस DSN। इसके बिना गेटवे केवल हेल्थ-ओनली मोड में चलता है। |
AIHUMMER_DB_APP_URL |
प्रतिबंधित-भूमिका DSN जो रो-स्तरीय सुरक्षा को सक्रिय करता है (स्थानीय इंस्टॉलों के लिए स्वचालित रूप से सेट किया गया)। |
AIHUMMER_GATEWAY_ADDR |
वेब पैनल, ऐप और चैनल सर्वर के एक ही सार्वजनिक पते का उपयोग करते हैं। इंस्टॉलर में दिखाया गया सार्वजनिक पता खोलें; स्थानीय डिफ़ॉल्ट पता http://localhost:8780/ है। स्थापना में चुना गया पोर्ट अलग हो सकता है। |
AIHUMMER_WEBUI_ADDR |
AIHUMMER_WEBUI_ADDR शुरुआती सेटअप की संगतता के लिए केवल loopback पर सहायक ऑपरेटर लिसनर है; डिफ़ॉल्ट 127.0.0.1:8781 है। यह पैनल का अलग बाहरी पता नहीं है; 0 अमान्य है। AIHUMMER_WEBUI_ENABLED=false दोनों लिसनर पर पैनल बंद करता है। |
AIHUMMER_DEFAULT_WORKSPACE_ID |
संरचित इनबाउंड इंटीग्रेशनों के लिए डिफ़ॉल्ट कार्यक्षेत्र चुनता है। |
AIHUMMER_HOME_ROOT |
रूट इंस्टॉल करें (सामान्यतः बाइनरी पथ से प्राप्त किया जाता है); यह admin-ui/blob/installer डायरैक्टरी और मुख्य फाइलों को एंकर करता है। |
AIHUMMER_BLOB_DIR |
मीडिया/फ़ाइल सेवा (ब्लॉब स्टोरेज निर्देशिका) सक्षम करता है। यह भी संग्रहित करता है निजी (साइड-लोड किए गए) प्लगइन आर्टिफैक्ट्स के नीचे blob: रेफरेंस जिन्हें डिप्लॉयर हल करता है। |
AIHUMMER_ADMIN_UI_DIR |
वेब पैनल, ऐप और चैनल सर्वर के एक ही सार्वजनिक पते का उपयोग करते हैं। / |
रहस्य और अवसंरचना
| चर | उद्देश्य |
|---|---|
AIHUMMER_MASTER_KEY |
बेस64-एन्कोडेड 32 बाइट्स; रहित रहस्यों, वॉल्ट और BYOK को सक्षम करता है। |
AIHUMMER_MEDIA_TOKEN_SECRET |
साइन किए गए डाउनलोड URL को पुनःप्रारंभ के बाद भी वैध बनाए रखता है। |
AIHUMMER_OTEL_ENDPOINT |
ट्रेस/मेट्रिक्स पुश के लिए OTLP एंडपॉइंट। |
AIHUMMER_DOWNLOAD_BASE_URL |
रिलीज़ आर्टिफैक्ट्स के लिए बेस यूआरएल (स्वयं-अपडेट स्रोत)। |
[!WARNING] प्रेक्षणीयता है केवल OTLP पुश. ऐआईहमर करता है नहीं एक प्रोमेथियस को उजागर करना
/metricsएंडपॉइंट या/debug/pprof. बिंदुAIHUMMER_OTEL_ENDPOINTआपके पास इसके बजाय कलेक्टर।
सेटिंग्स कैटलॉग (डेटाबेस — वेब एडमिन UI या aihummer settings)
नीचे हर कुंजी डेटाबेस में रहती है। इसे वेब प्रशासन UI में सेट करें (प्रबंधन → सेटिंग्स) या ऐसे:
aihummer settings set AIHUMMER_LLM_PROVIDER openai
ए gateway.env ऐसी कुंजी के लिए मान है उपेक्षित.
सुरक्षा
| चाबी | उद्देश्य |
|---|---|
AIHUMMER_APPROVAL_TOOLS |
ऐसे उपकरण जिन्हें चलाने से पहले मानवीय अनुमोदन की आवश्यकता होती है। |
AIHUMMER_AIRGAPPED |
1 मॉडल-नियंत्रित सार्वजनिक निकास (एयर-गैप मोड) को ब्लॉक करता है। |
AIHUMMER_AUDIT_RETENTION_DAYS |
एडमिन ऑडिट लॉग के लिए प्रतिधारण विंडो। |
AIHUMMER_INBOUND_SECRET |
कनेक्टर → गेटवे के लिए HMAC साझा गुप्त /v1/inbound/* कॉलें। |
प्रमाणीकरण और एसएसओ
| चाबी | उद्देश्य |
|---|---|
AIHUMMER_OIDC_ISSUER |
सुरक्षित करता है /v1/admin/*. इसके बिना (और LDAP/SAML के बिना) एडमिन डेवलपर हेडर्स पर भरोसा करता है — कभी भी ऐसे इंस्टेंस को एक्सपोज़ न करें। |
LDAP/AD और SAML को एंटरप्राइज साइन-इन के लिए OIDC के साथ कॉन्फ़िगर किया गया है; SCIM स्वचालित उपयोगकर्ता प्रोविजनिंग प्रदान करता है। देखें वेबहुक्स, एससीआईएम और पेयरिंग.
एलएलएम और मॉडल
| चाबी | उद्देश्य |
|---|---|
AIHUMMER_LLM_PROVIDER |
उपयोग करने के लिए मॉडल प्रदाता। |
AIHUMMER_LLM_MODEL |
मॉडल का नाम। |
AIHUMMER_LLM_GATEWAY_URL |
OpenAI-संगत LLM गेटवे/एंडपॉइंट का बेस URL (AIHUMMER_LLM_* मार्ग; मूल AIHUMMER_OPENAI_BASE_URL से अलग)। देखें BYOK और प्रदाता। |
AIHUMMER_OPENAI_API_KEY |
OpenAI-संगत प्रदाता के लिए API कुंजी। |
AIHUMMER_SUBAGENT_MAX_DEPTH |
जन्मे हुए उप-एजेंट्स की अधिकतम गहराई। |
[!NOTE] काम के उत्तर पाने के लिए वास्तविक मॉडल प्रदाता जोड़ें। सशुल्क API कुंजी अनिवार्य नहीं है: स्थानीय OpenAI-संगत मॉडल, समर्थित सदस्यता या अपनी API कुंजी इस्तेमाल कर सकते हैं। अगर कोई प्रदाता कॉन्फ़िगर नहीं है, तो यह त्रुटि दिखती है:
अभी तक कोई AI मॉडल प्रदाता कॉन्फ़िगर नहीं किया गया है - मॉडल अनुभाग में एक जोड़ें
उपकरण
| चाबी | उद्देश्य |
|---|---|
AIHUMMER_FS_ROOT |
अनुमत फ़ाइल रूट को और सीमित करता है; खाली मान होस्ट की पहुँच नहीं देता। |
AIHUMMER_DB_QUERY_DSN |
सक्षम करता है db_query (केवल-पढ़ने के लिए) इस DSN के खिलाफ। |
AIHUMMER_CODE_EXEC |
code_exec डिफ़ॉल्ट रूप से बंद है। |
AIHUMMER_BROWSER_PROFILE_SOCKET |
ब्राउज़र सेवा के निजी managed-profiles.sock सॉकेट का पथ; खाली — स्थायी computer प्रोफ़ाइल बंद। |
AIHUMMER_BROWSER_PROFILE_BINDINGS |
स्थायी ब्राउज़र प्रोफ़ाइल की स्पष्ट बाइंडिंग का JSON ऐरे (profile_id, tenant_id, user_id, agent_ids, conversation_ids)। |
वेब खोज और ब्राउज़र का प्रबंधन इंस्टॉलर करता है: वे आउट-ऑफ़-द-बॉक्स इंस्टॉल होते हैं,
--no-search / --no-browser से बंद किए जाते हैं, और
--external-search=URL / --external-browser=URL से किसी मौजूदा इंस्टेंस की ओर
इंगित किए जाते हैं — उनके लिए कोई ऑपरेटर सेटिंग नहीं है।
पूरा देखें उपकरण सूची प्रत्येक उपकरण क्या करता है के लिए।
वॉइस और साइडकार
| चाबी | उद्देश्य |
|---|---|
AIHUMMER_STT_URL |
स्पीच-टू-टेक्स्ट साइडकार URL (इंस्टॉलर द्वारा बीजित)। |
AIHUMMER_TTS_URL |
टेक्स्ट-टू-स्पीच साइडकार यूआरएल (इंस्टॉलर द्वारा बीजित)। |
AIHUMMER_VIDEO_URL |
वीडियो-समझने वाला साइडकार URL। |
AIHUMMER_TTS_AUTO_REPLY |
तैयार जवाब कब बोला जाए: off, always, inbound (डिफ़ॉल्ट), tagged। |
AIHUMMER_TTS_MAX_CHARS |
बोले जाने वाले पाठ की सीमा: 0 — पूरा जवाब, अन्यथा 100–10000 अक्षर। |
AIHUMMER_TTS_SUMMARIZE |
बोलने के लिए लंबे जवाब को छोटा करना (डिफ़ॉल्ट रूप से चालू)। |
साइडकार अलग HTTP सेवाएँ होती हैं; गेटवे उन्हें URL के माध्यम से पहुँचता है।
वेक्टर और एम्बेडिंग
| चाबी | उद्देश्य |
|---|---|
AIHUMMER_QDRANT_URL |
वास्तविक वेक्टर स्टोर (क्यूड्रांट)। अनुपस्थित → इन-मेमोरी स्टोर। |
AIHUMMER_EMBEDDER_URL |
असली एम्बेडर सेवा। अनुपस्थित → हैश एम्बेडर। |
प्रोटोकॉल सतहें (ऑप्ट-इन)
| चाबी | उद्देश्य |
|---|---|
AIHUMMER_MCP_PUBLISH |
ठीक 1 होने पर POST /v1/mcp पर बाहरी MCP सर्वर खुलता है। अकेले यह कोई उपकरण निर्यात नहीं करता। |
AIHUMMER_MCP_EXPORT_TOOLS |
अल्पविराम से अलग किए गए सटीक उपकरण नाम, जो MCP क्लाइंट को दिखेंगे। खाली (डिफ़ॉल्ट) = शून्य उपकरण निर्यात होते हैं। |
AIHUMMER_A2A_PUBLISH |
1 A2A सतह को सक्षम करता है (/.well-known/agent.json, /a2a/message). |
केवल देव बनाता है
| चर | उद्देश्य |
|---|---|
AIHUMMER_PLUGIN_PUBKEY |
प्लगइन हस्ताक्षरों को सत्यापित करने के लिए एक अतिरिक्त विश्वसनीय सार्वजनिक कुंजी (base64 ed25519)। केवल देव निर्माण — रिलीज़ निर्माण में अनदेखा किया गया (रजिस्ट्री कुंजी बाइनरी में पिन की गई है)। |
AIHUMMER_PLUGIN_DEV_UNSIGNED |
1 इंस्टॉल करने की अनुमति देता है असाइन किया हुआ नहीं प्लगइन्स। केवल देव निर्माण — रिलीज़ निर्माण में अनदेखा किया गया। कभी भी बाहरी रूप से पहुँच योग्य इंस्टेंस पर नहीं। |
[!WARNING] रिलीज़ बिल्ड्स में प्लगइन ट्रस्ट रूट है बाइनरी में बेक किया हुआ और पर्यावरण या सेटिंग्स द्वारा ओवरराइड नहीं किया जा सकता — यह एक एंटी-टैम्पर है गारंटी।
ट्रस्ट मॉडल (आधिकारिक → पिन की, निजी → ट्रस्ट स्टोर, बिना हस्ताक्षर वाले → अवरुद्ध) में वर्णित है स्थापित करें और अपडेट.
अगला कहाँ
- देखें कि कौन सा कुंजी किस टूल को अनलॉक करता है: उपकरण सूची.
- इंस्टेंस का दैनिक संचालन करें: CLI संदर्भ.