कॉन्फ़िगरेशन

~/.aihummer/etc/gateway.env

# ~/.aihummer/etc/gateway.env (excerpt)
AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer
AIHUMMER_MASTER_KEY=base64-32-bytes...
AIHUMMER_GATEWAY_ADDR=:8780
AIHUMMER_WEBUI_ADDR=:8781
AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main

systemctl restart aihummer-gateway

# Wire a real model (unset → deterministic mock)
aihummer settings set AIHUMMER_LLM_PROVIDER openai
aihummer settings set AIHUMMER_LLM_MODEL gpt-4o-mini
aihummer settings set AIHUMMER_LLM_GATEWAY_URL https://api.openai.com/v1

# Enable tools by pointing at their backends

# Voice sidecars (STT/TTS auto-configured by the installer)
aihummer settings set AIHUMMER_STT_URL http://localhost:8001
aihummer settings set AIHUMMER_TTS_URL http://localhost:8002

# Real vector store + embedder (example URLs; the embedder is installed with
# --with-embedder, otherwise memory uses the lexical fallback)
aihummer settings set AIHUMMER_QDRANT_URL http://localhost:6333
aihummer settings set AIHUMMER_EMBEDDER_URL http://localhost:8080

AiHummer को एक के माध्यम से कॉन्फ़िगर किया गया है **सेटिंग्स कैटलॉग**, पर्यावरण वेरिएबल्स का ढेर नहीं। `gateway.env` है **सिर्फ़ बूटस्ट्रैप**: डेटाबेस DSN, सुनने वाले पते/पोर्ट, मास्टर की और इसी तरह। हर अन्य कुंजी डेटाबेस में रहती है और रनटाइम पर या वेब एडमिन UI से बदली जाती है `aihummer settings` CLI। मार्गदर्शक नियम सरल है: **वेब यूआई में सब कुछ जिसे ट्यून किया जा सकता है, उसे कॉन्फ़िगर किया जा सकता है** — केवल एन्वायरनमेंट नहीं, और हार्डकोडेड भी नहीं। ## संकल्प आदेश हर कैटलॉग सेटिंग उसी तरह हल की जाती है, पहले मेल वाली जीतती है: 1. **डेटाबेस** — एक मान जो व्यवस्थापक UI के माध्यम से सेट किया गया है या `aihummer settings set`. 2. **डिफ़ॉल्ट** — रिलीज़ के साथ भेजा गया अंतर्निहित डिफ़ॉल्ट। पर्यावरण है **जानबूझकर इस श्रृंखला का हिस्सा नहीं**: सूची कुंजियों के लिए `AIHUMMER_*` वेरिएबल में `gateway.env` है **उपेक्षित**चाहे यह सेट किया गया हो। यह हर सेटिंग को बिल्कुल एक ही सत्य स्रोत देता है — डेटाबेस — ताकि कोई UI मूल्य कभी भी किसी भूल गए env फ़ाइल की लाइन द्वारा चुपचाप छाया न जाए। > [!NOTE] > प्रोडक्शन में व्यवहार बदलने के लिए आप कॉन्फ़िग फाइलों को एडिट नहीं करते — आप बदलते हैं > एडमिन यूआई में सेटिंग (**प्रबंधन → सेटिंग्स**, एक खोजने योग्य पृष्ठ) या चलाएं > `aihummer settings set <KEY> <VALUE>` (`get` / `list` पढ़ने के लिए), और इसमें लगता है > उस कार्यक्षेत्र के लिए प्रभाव। इंस्टॉलर स्वयं प्रारंभिक सूची मान उत्पन्न करता है > डेटाबेस के माध्यम से `aihummer settings set`. ## हॉट बनाम पुनःआरंभ की आवश्यकता किसी बदली हुई सेटिंग का प्रभाव इस बात पर निर्भर करता है कि कुंजी क्या है: | व्यवहार | उदाहरण | जब यह लागू होता है | |---|---|---| | **गर्म** | टूल सक्षम करना, उप-एजेंट अधिकतम गहराई | रनटाइम पर फिर से पढ़ें, कोई पुनः प्रारंभ नहीं | | **पुनःप्रारंभ-आवश्यक** | सुनने का पता, कुछ सेवाओं की वायरिंग | अगली गेटवे पुनःप्रारंभ पर लागू किया गया | हॉट कीज को सीधे पढ़ा जाता है, इसलिए किसी टूल को टॉगल करना या समायोजित करना `subagent-depth` अगली चाल पर प्रभाव डालता है। कुछ संरचनात्मक कुंजी केवल पुनःआरंभ के बाद प्रभाव डालती हैं; व्यवस्थापक UI यह संकेत करता है कि कौन सी कौन सी है। ## बूटस्ट्रैप वेरिएबल केवल एन्वाईरनमेंट तक ही सीमित रहते हैं कुछ वेरिएबल्स वातावरण में मौजूद होने चाहिए क्योंकि उनकी आवश्यकता सेटिंग्स कैटलॉग (और जिस डेटाबेस से यह पढ़ता है) के अस्तित्व में आने से पहले होती है। ये **बूटस्ट्रैप** वेरिएबल्स केवल एन्वायरनमेंट के लिए हैं और एडमिन UI में प्रदर्शित नहीं होते: | चर | यह बूटस्ट्रैप क्यों है | |---|---| | `AIHUMMER_DATABASE_URL` | किसी भी DB-समर्थित सेटिंग को पढ़ने से पहले DB का अस्तित्व होना चाहिए। | | `AIHUMMER_DB_APP_URL` | सीमित भूमिका DSN जो RLS को सक्रिय करता है। | | `AIHUMMER_MASTER_KEY` | base64-32 बाइट्स; रहस्यों-विश्राम / वॉल्ट / BYOK को अनलॉक करता है। | | `AIHUMMER_GATEWAY_ADDR` | सार्वजनिक श्रवण पता (डिफ़ॉल्ट) `:8780`) — एपीआई, पेयरिंग, WS/SSE, इनबाउंड और ऐप/पॉकेट प्रॉक्सी। | | `AIHUMMER_WEBUI_ADDR` | निजी प्रशासन वेब UI सुनने का पता (डिफ़ॉल्ट) `:8781`), जड़ पर परोसा गया `/`; सेट करें `0` अक्षम करने के लिए। | | `AIHUMMER_BLOB_DIR` | ब्लॉब/मीडिया निर्देशिका का फाइलसिस्टम पथ — बूट के समय आवश्यक। | | `AIHUMMER_OIDC_ISSUER` | सुरक्षित करता है `/v1/admin/*` UI पर भरोसा करने से पहले। | ऑप्स वायरिंग जैसे कि टेलीमेट्री OTLP एंडपॉइंट उसी बूटस्ट्रैप श्रेणी में आता है। इस छोटी सूची में जो कुछ भी नहीं है वह एक कैटलॉग कुंजी है: यह डेटाबेस में रहता है, और इसके लिए env को नजरअंदाज किया जाता है। > [!WARNING] > रखना `AIHUMMER_MASTER_KEY` सुरक्षित और बैकअप किया हुआ **अलग-अलग** आपके डेटाबेस से > बैकअप। यह क्रेडेंशियल वॉल्ट को डिक्रिप्ट करता है; इसे खो दें और एन्क्रिप्ट किया हुआ रहस्य भी खो जाएगा > पुनर्प्राप्त नहीं किया जा सकता। ## कॉन्फ़िग फाइल होस्ट-नेटिव इंस्टॉलेशन के लिए, बूटस्ट्रैप वातावरण एक ही फाइल में रहता है जिसे systemd यूनिट लोड करती है: ```text ~/.aihummer/etc/gateway.env ``` इस फ़ाइल को संपादित करें **केवल बूटस्ट्रैप मानों के लिए**फिर बदलाव लागू करने के लिए गेटवे सेवा को पुनरारंभ करें: ```ini # ~/.aihummer/etc/gateway.env (excerpt) AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer AIHUMMER_MASTER_KEY=base64-32-bytes... AIHUMMER_GATEWAY_ADDR=:8780 AIHUMMER_WEBUI_ADDR=:8781 AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main ``` ```bash systemctl restart aihummer-gateway ``` इन बूटस्ट्रैप कीज़ के अलावा सब कुछ — एजेंट्स, टूल्स, मेमोरी मोड, तर्क रणनीतियाँ, बजट, गार्डरेल्स और बाकी सब — एडमिन यूआई की सेटिंग्स से प्रबंधित किया जाता है (या इसके माध्यम से `aihummer settings`), इस फ़ाइल से नहीं: उन कुंजी के लिए env को नजरअंदाज किया जाता है। ## वायरिंग वैकल्पिक क्षमताएँ कई सुविधाएँ उस समय तक बंद रहती हैं जब तक आप उन्हें किसी बैकिंग सेवा की ओर इशारा नहीं करते। ये सभी कुंजी कैटलॉग सेटिंग्स हैं (वे डेटाबेस में रहते हैं): उन्हें एडमिन UI में सेट करें (**प्रबंधन → सेटिंग्स**) या CLI के साथ; उन्हें रखकर `gateway.env` कुछ नहीं करता — उनके लिए env को अनदेखा किया जाता है। बंडल (STT/TTS आदि) से इंस्टॉल किए गए साइडकार्स के लिए, इंस्टॉलर स्वयं डेटाबेस में मान दर्ज करता है। ```bash # Wire a real model (unset → deterministic mock) aihummer settings set AIHUMMER_LLM_PROVIDER openai aihummer settings set AIHUMMER_LLM_MODEL gpt-4o-mini aihummer settings set AIHUMMER_LLM_GATEWAY_URL https://api.openai.com/v1 # Enable tools by pointing at their backends # Voice sidecars (STT/TTS auto-configured by the installer) aihummer settings set AIHUMMER_STT_URL http://localhost:8001 aihummer settings set AIHUMMER_TTS_URL http://localhost:8002 # Real vector store + embedder (example URLs; the embedder is installed with # --with-embedder, otherwise memory uses the lexical fallback) aihummer settings set AIHUMMER_QDRANT_URL http://localhost:6333 aihummer settings set AIHUMMER_EMBEDDER_URL http://localhost:8080 ``` > [!TIP] > एक वास्तविक मॉडल कभी जरूरी नहीं होता। बिना `AIHUMMER_LLM_*` वायर्ड, जवाब आते हैं > एक निर्धारित मॉक से; AiHummer भी मुफ़्त/स्थानीय OpenAI-संगत पर चलता है > एंडपॉइंट्स और एक Codex/ChatGPT-सब्सक्रिप्शन ट्रांसपोर्ट, वैकल्पिक BYOK के साथ। ## सूचनाएँ एडमिन यूआई के **सूचनाएँ** पृष्ठ ("नियंत्रण" के अंतर्गत) घटना का इनबॉक्स होता है (प्रशासनिक साइन-इन, उपलब्ध/लागू अपडेट, साइडकार डाउन होना या रिकवर होना, आदि) जिसे श्रेणी, गंभीरता और अपठित द्वारा फिल्टर किया जा सकता है। इसके बगल में एक **श्रेणी × वितरण-चैनल मैट्रिक्स**: प्रत्येक घटना श्रेणी के लिए आप सक्षम करते हैं **वेबयूआई**, **ईमेल**, **टेलीग्राम** और **धक्का देना** चैनल। वेब यूआई नोटिस स्थानीय रूप से भेजे जाते हैं; टेलीग्राम "लिंक टेलीग्राम" बटन (डीप लिंक) के साथ जुड़ा होता है, ईमेल समर्थन पते की पुष्टि होने के बाद सक्रिय होता है, और पुश मोबाइल ऐप में आता है। गंभीर घटनाओं को वेबयूआई चैनल पर म्यूट नहीं किया जा सकता। ## अगला कहाँ - एडमिन लॉगिन को लॉक करें: [पहली बार लॉगिन](/hi/v1.0/getting-started/first-login). - देखें फाइलें कहाँ रहती हैं: [स्थापना](/hi/v1.0/getting-started/installation). - पूर्वापेक्षाएँ जांचें: [आवश्यकताएँ](/hi/v1.0/getting-started/requirements).