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

Kody एक पर्सनल असिस्टेंट प्लेटफ़ॉर्म है जिसे एक AI एजेंट की मेमोरी, कुंजियों, कोड और ऑटोमेशन के लिए एक घर के रूप में डिज़ाइन किया गया है, जिसका लक्ष्य संगत MCP होस्ट्स के बीच पोर्टेबल बने रहना है। इसे Cloudflare Workers और Model Context Protocol पर बनाया गया है, और इसमें एक Remix UI, Worker-आधारित रिक्वेस्ट रूटिंग, पैकेज रनटाइम प्लंबिंग और OAuth-संरक्षित MCP एंडपॉइंट्स शामिल हैं। आर्किटेक्चर और दायरा परियोजना एक बड़े स्थिर टूल कैटलॉग के बजाय सर्च और कोड मोड एक्ज़ीक्यूट फ़्लो के साथ एक कॉम्पैक्ट MCP सतह का पक्ष लेती है। इसे एक मल्टी-यूज़र पर्सनल असिस्टेंट के रूप में वर्णित किया गया है: प्रत्येक साइन-इन यूज़र को पैकेज, जॉब्स, सीक्रेट्स, मेमोरी और संबंधित स्टेट को कवर करने वाला एक पूरी तरह से अलग असिस्टेंट मिलता है। टेस्ट और फिक्स्चर नियतात्मक स्थानीय खातों को सीड कर सकते हैं, लेकिन रनटाइम पर कोई खाता विशेषाधिकार प्राप्त नहीं होता है। README बताता है कि यह परियोजना एक सामान्य उद्देश्य वाला एजेंट हार्नेस नहीं बल्कि एक फेयर सोर्स पर्सनल असिस्टेंट प्लेटफ़ॉर्म है, और यह कि ChatGPT संभावित प्राथमिक होस्ट लक्ष्य है, जबकि सर्वर को व्यावहारिक रूप से अन्य MCP होस्ट्स से उपयोग योग्य रखा जाता है। रिपॉजिटरी लेआउट रिपो एक Nx मोनोरेपो है। साझा मॉड्यूल packages/shared में रहते हैं, मूल ऐप वर्कर packages/worker में, पैकेज/platform-worker, packages/runtime-worker और packages/jobs-worker में सहोदर वर्कर के साथ, साथ ही packages/mock-servers के अंतर्गत मॉक वर्कर। प्रोडक्शन टोपोलॉजी docs/contributing/architecture में दस्तावेजित है। वर्णित रिक्वेस्ट फ़्लो है: OAuth रिक्वेस्ट को पहले संभाला जाता है, फिर MCP रिक्वेस्ट, फिर स्थिर एसेट; गैर-एसेट रिक्वेस्ट सर्वर हैंडलर और राउटर पर आ जाते हैं, और क्लाइंट एसेट packages/worker/public में बंडल किए जाते हैं और ASSETS बाइंडिंग के माध्यम से परोसे जाते हैं। टेक स्टैक रनटाइम: Cloudflare Workers। UI फ्रेमवर्क: Remix 3 (बीटा)। पैकेज मैनेजर: npm। वर्कस्पेस: Nx और npm वर्कस्पेस। डेटाबेस: Cloudflare D1। सत्र/OAuth: Cloudflare KV। MCP स्टेट: kody-platform पर Durable Objects। ई2ई टेस्टिंग: Playwright। बंडलर: Vite। शुरुआत करना डिपेंडेंसी इंस्टॉल करने के लिए npm install चलाएँ और डेव सर्वर शुरू करने के लिए npm run dev। डेव सर्वर डिफ़ॉल्ट रूप से localhost:3742 पर चलता है, जिसमें CLI अगला मुक्त पोर्ट चुनता है और हल किया गया URL प्रिंट करता है; Wrangler स्थानीय Cloudflare Workers रनटाइम और D1 डेटाबेस को स्वचालित रूप से संभालता है। इसके बजाय epicflare टेम्पलेट से एक नया प्रोजेक्ट बनाने के लिए, README npx create-epicflare की ओर इशारा करता है। आगे के सेटअप पथ और अपेक्षाएँ docs/contributing/getting-started.md में हैं, और योगदानकर्ताओं और एजेंटों को रिपो-विशिष्ट मार्गदर्शन के लिए AGENTS.md भेजा जाता है। परियोजना का उद्देश्य docs/contributing/project-intent.md में दस्तावेजित है। दस्तावेज़ीकरण और योगदान README सेटअप, पर्यावरण चर, वैकल्पिक Cloudflare एकीकरण, परियोजना उद्देश्य, Kody को विकसित और विस्तारित करना, MCP पर Kody का उपयोग, और स्थानीय विकास और सत्यापन को कवर करने वाले दस्तावेज़ीकरण को लिंक करता है। बाहरी पुल रिक्वेस्ट के लिए हस्ताक्षरित इनबाउंड योगदानकर्ता लाइसेंस समझौते (CLA) की आवश्यकता होती है; Kody के माध्यम से प्रकाशित सार्वजनिक पैकेज उस CLA का उपयोग नहीं करते हैं। रिपॉजिटरी Functional Source License 1.1 के तहत Apache 2.0 भविष्य के लाइसेंस के साथ लाइसेंस प्राप्त है, जो प्रतिस्पर्धी उपयोग के अलावा किसी भी उद्देश्य के लिए उपयोग, प्रतिलिपि, संशोधन, व्युत्पन्न कार्य, सार्वजनिक प्रदर्शन, प्रदर्शन और पुनर्वितरण की अनुमति देता है, प्रत्येक संस्करण अपनी रिलीज़ की दूसरी वर्षगांठ पर Apache 2.0 के तहत उपलब्ध हो जाता है।