इस प्रोजेक्ट के बारे में

Koris Assistant एक स्वायत्त AI एजेंट फ्रेमवर्क है जो सख्त TypeScript में लिखा गया है और Node.js 24+ तथा pnpm के साथ चलता है। यह चार प्लगइन परिवारों के साथ एक मॉड्यूलर सिस्टम के रूप में व्यवस्थित है: चैनल, उपकरण, कौशल, और MCP सर्वर। प्लगइन्स को एक साथी हब रिपॉजिटरी से मांग पर डाउनलोड किया जा सकता है और एजेंट को पुनः आरंभ किए बिना हॉट-लोड किया जा सकता है। चैनलों में Telegram, WhatsApp, एक इंटरैक्टिव टर्मिनल UI, और एक React 19 वेब डैशबोर्ड शामिल हैं। एक एकीकृत संदेश गेटवे और सत्र प्रबंधक इन सभी को संचालित करते हैं। फ्रेमवर्क स्ट्रीमेबल HTTP पर मॉडल कॉन्टेक्स्ट प्रोटोकॉल का भी समर्थन करता है, दूरस्थ उपकरणों की खोज करता है और उन्हें LLM टूल पाइपलाइन के अंदर server__tool के रूप में नामस्थानित करता है। वॉयस समर्थन स्थानीय है: स्पीच-टू-टेक्स्ट sherpa-onnx के माध्यम से Whisper का उपयोग करता है और टेक्स्ट-टू-स्पीच Piper न्यूरल वॉयस का उपयोग करता है, दोनों पोर्ट 6006 पर एक हल्के साइडकार द्वारा परोसे जाते हैं। WhatsApp या वेब UI में वॉयस नोट्स स्वचालित रूप से ट्रांसक्राइब किए जाते हैं, और प्रति-वार्तालाप वॉयस रिप्लाई मोड उपलब्ध है। मेमोरी और सत्र SQLite में संग्रहीत हैं, जिसमें दीर्घकालिक तथ्य, पाठ, सारांश, सिमेंटिक एम्बेडिंग, सत्र ट्रैकिंग, और वार्तालाप इतिहास शामिल हैं। मॉडल एक्सेस बहु-प्रदाता है: Ollama, OpenAI-संगत प्रीसेट जैसे openai, deepseek, groq, openrouter, xai, mistral, together, gemini, और nvidia, साथ ही एक Mock प्रदाता। विभिन्न प्रदाताओं और मॉडलों को प्रति भूमिका निर्दिष्ट किया जा सकता है, उदाहरण के लिए मुख्य एजेंट बनाम पृष्ठभूमि कार्यकर्ता बनाम एम्बेडिंग। क्लाइंट शेल में वेब डैशबोर्ड, TUI, मूल OS वेबव्यू का उपयोग करने वाला एक Tauri डेस्कटॉप ऐप, और एक Electron डेस्कटॉप शेल शामिल हैं। हार्टबीट एजेंट नामक अनुसूचित क्रॉन-संचालित पृष्ठभूमि उप-एजेंट स्वायत्त दिनचर्या, रखरखाव, और सूचनाओं को संभालते हैं। टूल निष्पादन सैंडबॉक्स किया गया है, जिसमें डोमेन-गेटेड HTTP curl, स्व-होस्टेड SearXNG वेब खोज, मुद्दा ट्रैकिंग, बीट प्रबंधन, स्टिकर, और कस्टम प्लगइन्स शामिल हैं। परियोजना एक "errands" सुविधा का दस्तावेजीकरण करती है: एक Negotiator एजेंट प्लगइन द्वारा चलाई गई प्रत्यायोजित वार्तालाप जो अनुरोध करने वाले उपयोगकर्ता को सूचित रखते हुए एक संपर्क के साथ एक लक्ष्य का पीछा करती है। प्रत्येक errand प्रति लक्ष्य एक नया प्रत्यायोजित चाइल्ड सत्र बनाता है, जिसमें मूल सत्र ID, errand ID, और निर्देश SQLite मेटाडेटा में संग्रहीत होते हैं। कमांड में errands की सूची बनाना, अनुमोदन करना, उत्तर देना, पुनः प्रयास करना, बंद करना, और रद्द करना शामिल है। README राज्य संक्रमण, वितरण पुनर्प्राप्ति, कतार पदोन्नति, समाप्ति व्यवहार, और वेब पोलिंग तथा exactly-once वितरण के आसपास ज्ञात सीमाओं का वर्णन करता है। सेटअप में निर्भरताएँ स्थापित करना, एक उदाहरण सेटिंग्स फ़ाइल को koris.json में कॉपी करना या वेब सेटअप विज़ार्ड का उपयोग करना, कॉन्फ़िगरेशन को मान्य करना, और निर्माण करना शामिल है। एजेंट तब वेब सेवा, TUI, या डेस्कटॉप ऐप के रूप में चल सकता है। वैकल्पिक Docker Compose सेवाएँ SearXNG और ऑडियो साइडकार प्रदान करती हैं। परियोजना बताती है कि यह सख्त TypeScript जाँच, Vitest परीक्षण सूट, और Stryker म्यूटेशन परीक्षण का उपयोग करती है, और ISC के तहत लाइसेंस प्राप्त है।