Forkybot AI: Bytebot अनुकूलित और सुरक्षित

यह Bytebot का एक अनुकूलित और सुरक्षित फोर्क है, जो एक ओपन-सोर्स AI एजेंट है जो जटिल कार्यों को स्वचालित करने के लिए एक वर्चुअल डेस्कटॉप को नियंत्रित करता है।

मूल प्रोजेक्ट को संग्रहीत कर दिया गया था और यह बिना रखरखाव के रह गया। यह फोर्क विचार को बचाता है, इसे आधुनिक बनाता है और इसे उत्पादन के लिए तैयार करता है, सॉफ़्टवेयर इंजीनियरिंग, सुरक्षा और दस्तावेज़ीकरण की सर्वोत्तम प्रथाओं को लागू करते हुए।

🎯 यह प्रोजेक्ट क्या करता है?

एक वर्चुअल कर्मचारी की कल्पना करें जिसके पास अपना स्वयं का कंप्यूटर है। आप उसे प्राकृतिक भाषा में निर्देश दे सकते हैं जैसे "मेरे तीन आपूर्तिकर्ता पोर्टलों से इस महीने के चालान डाउनलोड करें और उन्हें एक फ़ोल्डर में व्यवस्थित करें" और एजेंट ब्राउज़र खोलेगा, पोर्टलों पर नेविगेट करेगा, फ़ाइलें डाउनलोड करेगा और उन्हें व्यवस्थित करेगा। सब कुछ स्वायत्त रूप से, लेकिन इस संभावना के साथ कि आप किसी भी समय नियंत्रण ले सकें (Human-in-the-loop)।

✨ मुख्य सुधार (इंजीनियरिंग चरण)

यह फोर्क एक साधारण प्रतिलिपि नहीं है। इसे अगले स्तर पर ले जाने के लिए तीन इंजीनियरिंग चरण किए गए:

चरण A: सुरक्षा (CVE-2026-78250 का पैच)

• अनंत लूप का शमन: सेवा-अस्वीकृति (DoS) और अनियंत्रित API खर्चों को रोकने के लिए कॉन्फ़िगर करने योग्य सुरक्षा सीमाएँ (MAX_TASK_ITERATIONS और TASK_TIMEOUT_MS) लागू की गईं।
• Human-in-the-loop: यदि कोई कार्य सीमाओं से अधिक हो जाता है, तो यह विफल नहीं होता। यह NEEDS_HELP में परिवर्तित हो जाता है ताकि कोई मानव हस्तक्षेप कर सके और इसे फिर से शुरू कर सके।

चरण B: अनुकूलन (आकार में 85% की कमी)

• Debian Bookworm-slim में माइग्रेशन: glibc, VS Code और 1Password के साथ पूर्ण संगतता बनाए रखता है, लेकिन अनावश्यक सॉफ़्टवेयर और निर्माण उपकरणों को हटा देता है।
• Multi-Stage Build: अंतिम इमेज अपना आकार ~7 GB से ~1.09 GB तक कम कर देती है, जिससे दक्षता में सुधार होता है और हमले की सतह कम होती है।
• गहन सफ़ाई: Thunderbird, xfce4-goodies और अनावश्यक संपादकों को हटा दिया गया।

चरण C: एकीकरण सत्यापन (Smoke Test)

• डेस्कटॉप, एजेंट, UI और डेटाबेस के समवर्ती स्टार्टअप का सत्यापन किया गया।
• आंतरिक (पोर्ट 9990 पर VNC) और बाहरी (पोर्ट 9992 पर UI) संचार की जाँच की गई।

📚 जीवंत दस्तावेज़ीकरण (Obsidian)

इस फोर्क का एक बड़ा योगदान इसका प्रोजेक्ट मस्तिष्क है, एक Obsidian वॉल्ट (vault/) जो AI (और मनुष्यों) के लिए संदर्भ के रूप में कार्य करता है ताकि वे खोए बिना आर्किटेक्चर के माध्यम से नेविगेट कर सकें। इसमें शामिल हैं:

• ADRs (आर्किटेक्चरल निर्णय रिकॉर्ड) जो प्रत्येक परिवर्तन के कारण को समझाते हैं।
• एजेंट, UI और वर्चुअल डेस्कटॉप के लिए विस्तृत फ़ाइल मैप।
• कार्य प्रोटोकॉल (PROTOCOLO_TRABAJO.md और PROTOCOLO_OBSIDIAN.md) जो परिभाषित करते हैं कि इस प्रोजेक्ट में एक AI एजेंट को कैसे काम करना चाहिए।

🛠️ उपयोग की गई तकनीकें

• एजेंट: NestJS (Node.js 20 Alpine)
• वर्चुअल डेस्कटॉप: Debian Bookworm-slim, XFCE, Xvfb, TigerVNC
• फ्रंटएंड: Next.js 15, Tailwind CSS, noVNC
• डेटाबेस: PostgreSQL 16
• इन्फ्रास्ट्रक्चर: Docker, Docker Compose, Multi-Stage Builds

🚀 शुरुआत कैसे करें

# रिपॉज़िटरी क्लोन करें
git clone https://github.com/TU_USUARIO/forkybot_AI.git
cd forkybot_AI

# पर्यावरण चर कॉन्फ़िगर करें (उदा. Gemini API Key)
echo "GEMINI_API_KEY=tu_clave_aqui" > docker/.env

# स्टैक लॉन्च करें
docker-compose -f docker/docker-compose.yml up -d

# इंटरफ़ेस तक पहुँचें
# अपने ब्राउज़र में http://localhost:9992 खोलें