প্রকল্প সম্পর্কে

Kody হলো একটি ব্যক্তিগত সহকারী প্ল্যাটফর্ম যা একটি AI এজেন্টের মেমরি, কী, কোড এবং অটোমেশনের আবাস হিসেবে ডিজাইন করা হয়েছে, যার লক্ষ্য সামঞ্জস্যপূর্ণ MCP হোস্টগুলোর মধ্যে বহনযোগ্য থাকা। এটি Cloudflare Workers এবং Model Context Protocol-এর উপর নির্মিত, এবং একটি Remix UI, Worker-ভিত্তিক রিকোয়েস্ট রাউটিং, প্যাকেজ রানটাইম প্লাম্বিং এবং OAuth-সুরক্ষিত MCP এন্ডপয়েন্ট সরবরাহ করে। আর্কিটেকচার এবং পরিধি প্রকল্পটি একটি বড় স্ট্যাটিক টুল ক্যাটালগের পরিবর্তে সার্চ এবং Code Mode execute ফ্লোসহ একটি সংক্ষিপ্ত MCP সারফেসকে প্রাধান্য দেয়। এটিকে একটি বহু-ব্যবহারকারী ব্যক্তিগত সহকারী হিসেবে বর্ণনা করা হয়েছে: প্রতিটি সাইন-ইন করা ব্যবহারকারী প্যাকেজ, জব, সিক্রেট, মেমরি এবং সম্পর্কিত স্টেট কভার করে একটি সম্পূর্ণ বিচ্ছিন্ন সহকারী পান। টেস্ট এবং ফিক্সচার ডিটারমিনিস্টিক লোকাল অ্যাকাউন্ট সিড করতে পারে, কিন্তু রানটাইমে কোনো অ্যাকাউন্ট বিশেষাধিকারপ্রাপ্ত নয়। README-তে বলা হয়েছে যে প্রকল্পটি একটি সাধারণ-উদ্দেশ্য এজেন্ট হার্নেসের পরিবর্তে একটি Fair Source ব্যক্তিগত সহকারী প্ল্যাটফর্ম, এবং ChatGPT একটি সম্ভাব্য প্রাথমিক হোস্ট টার্গেট, যেখানে সার্ভারটিকে যেখানে সম্ভব অন্যান্য MCP হোস্ট থেকে ব্যবহারযোগ্য রাখা হয়। রিপোজিটরি লেআউট রিপোটি একটি Nx মনোরিপো। শেয়ার্ড মডিউলগুলো packages/shared-এ থাকে, অরিজিন অ্যাপ ওয়ার্কার packages/worker-এ, সাথে packages/platform-worker, packages/runtime-worker এবং packages/jobs-worker-এ সিবলিং ওয়ার্কার, এবং packages/mock-servers-এর অধীনে মক Workers। প্রোডাকশন টপোলজি 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। E2E টেস্টিং: 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 ব্যবহার, এবং লোকাল ডেভেলপমেন্ট এবং ভেরিফিকেশন কভার করে এমন ডকুমেন্টেশনের লিঙ্ক দেয়। বাইরের পুল রিকোয়েস্টের জন্য একটি স্বাক্ষরিত ইনবাউন্ড Contributor License Agreement প্রয়োজন; Kody-এর মাধ্যমে প্রকাশিত পাবলিক প্যাকেজগুলো সেই CLA ব্যবহার করে না। রিপোজিটরি Functional Source License 1.1-এর অধীনে লাইসেন্সপ্রাপ্ত যার একটি Apache 2.0 ভবিষ্যৎ লাইসেন্স রয়েছে, যা Competing Use ছাড়া অন্য যেকোনো উদ্দেশ্যে ব্যবহার, কপি, পরিবর্তন, ডেরিভেটিভ ওয়ার্ক, পাবলিক পারফরম্যান্স, ডিসপ্লে এবং রিডিস্ট্রিবিউশনের অনুমতি দেয়, প্রতিটি সংস্করণ তার রিলিজের দ্বিতীয় বার্ষিকীতে Apache 2.0-এর অধীনে উপলব্ধ হয়।