सिस्टम आवश्यकताएँ

AiHummer एक होस्ट-नेटिव उत्पाद है: यह systemd के अंतर्गत एक रिलीज़ टारबॉल के रूप में चलता है, इसलिए आवश्यकताएँ जानबूझकर छोटी हैं। केवल हार्ड निर्भरता एक लिनक्स होस्ट है जिसमें PostgreSQL हो। बाकी सब कुछ — साइडकार्स, एक वास्तविक मॉडल, एक वेक्टर स्टोर — वैकल्पिक है और बाद में एडमिन UI से जोड़ा जा सकता है।

[!NOTE] AiHummer है होस्ट-नेटिव, Docker नहीं। यह टारबॉल के रूप में तैनात होता है जो के अंतर्गत चल रहा है systemd से ~/.aihummer (उस उपयोगकर्ता की होम डायरेक्टरी जिसने इसे चलाया) इंस्टॉलर)। आपको किसी कंटेनर रनटाइम, कुबेरनेट्स या किसी की आवश्यकता नहीं है संगीत निर्देशक।

संचालन प्रणाली

AiHummer पर चलता है सिर्फ लिनक्स. Windows या macOS सर्वर बिल्ड उपलब्ध नहीं है — गेटवे और इसके साइडकार आर्किटेक्चर-विशेष Linux आर्टिफैक्ट के रूप में पैक किए जाते हैं और systemd के साथ तैनात किए जाते हैं। (क्लाइंट एक अलग मोबाइल और डेस्कटॉप ऐप है; वह एक चैनल है, सर्वर नहीं।)

एक आधुनिक 64-बिट लिनक्स वितरण के साथ systemd.
x86_64 (amd64) या arm64 — इंस्टॉलर मिलान करने वाला प्रति-आर्क बंडल खींचता है।
sudo/रूट एक्सेस है सख्ती से आवश्यक नहीं: एक सामान्य स्थापना के माध्यम से चलती है sudo, लेकिन इंस्टॉलर को रूट के बिना चलाने पर AiHummer बिना रूट के इंस्टॉल होता है मोड के तहत systemd --user — देखना स्थापना.

डेटाबेस

पोस्टग्रेसक्यूएल है सिर्फ़ कड़ी निर्भरता और सभी राज्य के लिए सत्य का एकमात्र स्रोत। pgcrypto विस्तार है आवश्यक — यह एन्क्रिप्टेड क्रेडेंशियल वॉल्ट का समर्थन करता है। डेटाबेस के बिना, गेटवे एक सीमित केवल-स्वास्थ्य मोड में शुरू होता है और कुछ भी उपयोगी नहीं प्रदान करता।

[!IMPORTANT] सक्षम करें pgcrypto पहली बार चलाने से पहले लक्ष्य डेटाबेस में:
CREATE EXTENSION IF NOT EXISTS pgcrypto;

गेटवे एक DSN के माध्यम से कनेक्ट करता है AIHUMMER_DATABASE_URL. मल्टीटेनेंट पृथक्करण के लिए आप अतिरिक्त रूप से इशारा कर सकते हैं AIHUMMER_DB_APP_URL एक प्रतिबंधित पर aihummer_app Postgres Row-Level Security को सक्रिय करने के लिए भूमिका; स्थानीय इंस्टॉलेशन इसे स्वचालित रूप से सेट करते हैं। डेटाबेस माइग्रेशन आगे-सेफ हैं और मालिक पूल पर एक सलाहकारी लॉक के तहत स्वचालित रूप से लागू होते हैं।

हार्डवेयर

ये आंकड़े गेटवे और PostgreSQL के एकल-होस्ट परिनियोजन के लिए मार्गदर्शन हैं। साइडकार (STT/TTS, ब्राउज़र, वेक्टर स्टोर) अपना अलग पदचिह्न जोड़ते हैं और आमतौर पर केवल छोटे परिनियोजनों के लिए ही एक ही होस्ट पर रखे जाते हैं।

प्रोफ़ाइल	सीपीयू	रैम	डिस्क	नोट्स
न्यूनतम (मूल्यांकन)	2 वीसीपीयू	2 जीबी	10 जीबी	गेटवे + पोस्टग्रेस, मॉक मॉडल, कोई साइडकार नहीं
सिफारिश की गई	4 वीसीपीयू	8 जीबी	40 जीबी एसएसडी	गेटवे + पोस्टग्रेस + कुछ साइडकार
वॉइस / स्थानीय मॉडल	8+ vCPU (GPU वैकल्पिक)	16+ जीबी	80+ जीबी एसएसडी	एसटीटी/टीटीएस, एम्बेडर, लोकल एलएलएम एंडपॉइंट

डिस्क उपयोग वार्तालाप इतिहास के साथ बढ़ता है, मीडिया ब्लॉब निर्देशिका (AIHUMMER_BLOB_DIR), ज्ञान अवशोषण और ऑडिट प्रतिधारण। PostgreSQL बैकअप (pg_dump + WAL/PITR) को उसी के अनुसार योजना बनाएं।

साइडकार (वैकल्पिक)

साइडकार हैं अलग HTTP सेवाएँ, प्रत्येक अपने स्वयं के systemd यूनिट के अंतर्गत। गेटवे उन्हें URL के माध्यम से पहुँचता है, इसलिए एक साइडकार उसी होस्ट पर चल सकता है, दूसरे होस्ट पर चल सकता है, या आप किसी मौजूद इंस्टेंस की ओर इशारा कर सकते हैं। ये सभी मुफ्त/स्थानीय हैं और बुनियादी तैनाती के लिए कभी आवश्यक नहीं होते।

साइडकार	डिफ़ॉल्ट पोर्ट	सक्षम करता है
एसटीटी (फास्टर-व्हिस्पर)	8001	वॉइस टर्न्स के लिए स्पीच-टू-टेक्स्ट
टीटीएस (एज-टीटीएस)	8002	वॉइस टर्न्स के लिए टेक्स्ट-टू-स्पीच
वीडियो (ffmpeg)	8005	वीडियो समझ
SearXNG	8888	द `web_search` उपकरण
क्रोम/सीडीपी	9222	द `browser` / `computer` उपकरण

STT, TTS, वीडियो, वेब खोज (SearXNG) और ब्राउज़र (CloakBrowser) — ये सभी इंस्टॉलर द्वारा बॉक्स से बाहर इंस्टॉल किए जाते हैं। खोज और ब्राउज़र के पेलोड हस्ताक्षरित इंस्टॉलर बंडल के अंदर आते हैं और ऑफ़लाइन इंस्टॉल होते हैं: उन्हें --no-search / --no-browser से बंद करें, या स्थानीय इंस्टॉल के बजाय --external-search=URL / --external-browser=URL से पहले से चल रहे इंस्टेंस को जोड़ें। आवाज़ वाले साइडकार को AIHUMMER_SKIP_* चर से छोड़ें। सेमांटिक एम्बेडर है सहमति देना (--with-embedder): यह PyTorch (सैकड़ों MB) को खींचता है, और इसके बिना मेमोरी लेक्सिकल सर्च पर लौटती है। देखें स्थापना.

[!NOTE] Node.js (संस्करण 20 या नया) भी इंस्टॉलर बंडल के अंदर आता है और ऑफ़लाइन इंस्टॉल होता है, इसलिए Node.js प्लगइन्स — AiHummer ऐप, pocket-agent और चैनल कनेक्टर — उन डिस्ट्रीब्यूशनों पर भी बॉक्स से बाहर काम करते हैं जिनका अपना Node.js बहुत पुराना है।

एलएलएम प्रदाता

AiHummer को कभी भी भुगतान किए गए मॉडल की आवश्यकता नहीं होती। यह मुफ्त/स्थानीय मॉडलों और Codex/ChatGPT-सदस्यता परिवहन पर तुरंत काम करता है; प्रति-टेनेंट BYOK कुंजियाँ पूरी तरह से वैकल्पिक हैं।

समर्थित प्रदाता:

मानवकेंद्री
ओपनएआई.
कोई भी OpenAI-API-मानक एंडपॉइंट — स्थानीय मॉडल सर्वर, ओपनराउटर, या उदाहरण के लिए, जेमिनी का OpenAI-संगत एंडपॉइंट।
कोडेक्स / चैटजीपीटी-सदस्यता परिवहन — ChatGPT के माध्यम से एक मॉडल चलाएँ बिल किए गए API कुंजी के बजाय सदस्यता।

[!TIP] अगर आप गेटवे को बिना किसी मॉडल के वायर किए शुरू करते हैं (AIHUMMER_LLM_PROVIDER / AIHUMMER_LLM_MODEL / AIHUMMER_LLM_GATEWAY_URL), उत्तर एक निर्धारणात्मक से आते हैं मज़ाक उड़ाना तो आप चैनलों को मान्य कर सकते हैं और एक असली मॉडल से जुड़ने से पहले मार्गनिर्धारण।

[!NOTE] AiHummer केवल OpenAI-संगत को उजागर करता है POST /v1/chat/completions एंडपॉइंट। वहाँ है नहीं /v1/models या /v1/embeddings HTTP एंडपॉइंट, और ऑब्ज़र्वेबिलिटी OTLP-पुश है (कोई Prometheus नहीं) /metrics).

अगला कहाँ

तैनाती के लिए तैयार? जाएँ स्थापना.
पहले रन को कदम दर कदम चलना चाहते हैं? देखें त्वरित शुरुआत.
पहले मानसिक मॉडल चाहते हैं? पढ़ें परिचय.