منصوبے کے بارے میں

Cindy ایک اوپن سورس AI ایجنٹ ہے جس کا مقصد آؤٹ آف دی باکس کام کرنا ہے، جو متعدد harnesses، ماڈلز اور ٹولز کو ایک ایجنٹ میں یکجا کرتا ہے جو آپ کے پروجیکٹس اور ایپس کے اندر کام مکمل کرتا ہے۔ یہ آپ کی اپنی مشین پر مقامی طور پر چلتا ہے، آپ کی حقیقی فائلوں اور لاگ ان ایپلیکیشنز کا استعمال کرتے ہوئے۔ پہلے سپورٹ شدہ harnesses Claude Code اور Codex ہیں، مزید شامل کیے جا رہے ہیں اور ایک نیٹو harness زیرِ ترقی ہے۔ ماڈلز اور harnesses کو ٹاسک کے دوران مکس اور سوئچ کیا جا سکتا ہے جبکہ ورک اسپیس، میموری، اسکلز اور ٹولز مسلسل برقرار رہتے ہیں۔ ایک واحد ٹاسک کو مختلف harness اور ماڈل امتزاج پر ایجنٹس کے ذریعے پلان، متوازی طور پر عمل درآمد، اور جائزہ لیا جا سکتا ہے۔ Cindy آپ کے براؤزر، کمپیوٹر اور فون کو چلا سکتا ہے، اور IM اور شیڈولز سے کام لے سکتا ہے۔ یہ ریپوزٹری اوپن سورس کلائنٹ ہے: ڈیسک ٹاپ اور موبائل ایپس کے ساتھ ان کے مشترکہ پیکجز، جو pnpm monorepo کے طور پر منظم ہیں۔ بیک اینڈ سروس ایک الگ ریپوزٹری میں رہتی ہے اور اس monorepo کا حصہ نہیں ہے۔ ریپوزٹری لے آؤٹ: - apps/desktop — Electron ڈیسک ٹاپ کلائنٹ - apps/mobile — Expo / React Native موبائل کلائنٹ - packages/* — مشترکہ کلائنٹ صلاحیتیں جیسے auth، device-link، ایجنٹ آرکیسٹریشن اور ماڈل پرووائیڈرز - apps/*-bin — ڈیسک ٹاپ ایپ کے ساتھ بھیجے گئے ٹول بائنریز؛ claude-code، codex اور ripgrep ہر پلیٹ فارم کے لیے pnpm install کے ذریعے ڈاؤن لوڈ ہوتے ہیں، اور Android platform-tools بائنریز Windows پیکیجنگ سے پہلے ایک پن شدہ ورژن اور sha256 تصدیق کے ساتھ حاصل کیے جاتے ہیں README میں بیان کردہ حسب ضرورت اور توسیعی نکات میں شامل ہیں: میموری (تصحیحات harnesses کے درمیان برقرار رہتی ہیں)، اسکلز (کام کرنے کے دوبارہ قابل استعمال طریقے)، آٹومیشن (بار بار ہونے والا شیڈول شدہ کام جو واپس رپورٹ کرتا ہے)، MCP (اندرونی ٹولز اور بزنس سسٹمز کو جوڑنا)، پلگ انز (خصوصیات، UI اور تعاملات کو نئی شکل دینا، ایک اوپن مارکیٹ پلیس زیرِ تعمیر بتایا گیا ہے)، اور Apache-2.0 کے تحت آڈٹ، فورک اور تعاون کے لیے سورس تک رسائی۔ استعمال کے طریقے: ایک ہوسٹڈ سروس جس کے لیے Cindy کلاؤڈ اکاؤنٹ درکار ہے، یا ایک Skip Sign-In آپشن جو Cindy اکاؤنٹ کے بغیر مقامی ایجنٹس چلاتا ہے (Not signed in کے طور پر دکھایا جاتا ہے)، جہاں سرور سے چلنے والی صلاحیتیں دستیاب نہیں ہوتیں۔ ماڈلز سرکاری Cindy سروس، موجودہ Claude Code یا Codex Coding Plan اجازت، اپنی API کیز، یا مقامی ماڈلز کے ذریعے لائے جا سکتے ہیں۔ پیشگی تقاضے Node.js 22.x، pnpm 10.x (v11 ابھی سپورٹ نہیں) اور Git LFS ہیں۔ کم سے کم سیٹ اپ git clone، git lfs pull، پھر pnpm install ہے۔ ڈیولپمنٹ انٹری پوائنٹس میں pnpm restart:desktop:remote شامل ہے جس میں مین لینڈ چائنا اکاؤنٹس کے لیے --region=cn اور دیگر کے لیے --region=global ہے؛ ریموٹ ڈیولپمنٹ آپ کے اپنے Cindy کلاؤڈ اکاؤنٹ اور موجودہ لاگ ان حالت کا استعمال کرتی ہے۔ کلائنٹ بطور ڈیفالٹ config/endpoint.json اور config/endpoint.global.json میں endpoint manifests کے ذریعے Cindy کی سرکاری کلاؤڈ سروسز سے جڑتا ہے، اور ڈیسک ٹاپ آٹو اپڈیٹس سرکاری CDN سے آتی ہیں۔ دستاویزات کے اشارے میں شامل ہیں DESIGN.md بصری ڈیزائن سسٹم اور UI کنونشنز کے لیے، docs/README.md دستاویزات کے اشاریے کے طور پر، docs/auth-realm-routing.md SSO ریجن ڈسکوری اور سیشن endpoint روٹنگ کے لیے، CONTRIBUTING.en.md تعاون کنندہ سیٹ اپ اور توثیق کے لیے، AGENTS.md انجینئرنگ قواعد اور ماڈیول حدود کے لیے، اور docs/dev-rules/ گہرے آرکیٹیکچر دستاویزات جیسے Orca ملٹی ایجنٹ آرکیسٹریشن کے لیے۔ ایک Linux انسٹالیشن گائیڈ Ubuntu، Arch Linux اور Omarchy کا احاطہ کرتا ہے۔ تعاون main میں پل ریکوئسٹس کے ذریعے ہوتا ہے، Developer Certificate of Origin سائن آف (git commit -s) درکار ہے جو DCO چیک کے ذریعے نافذ ہوتا ہے، اور کوئی CLA درکار نہیں۔ سیکیورٹی مسائل SECURITY.en.md کے مطابق نجی طور پر رپورٹ کیے جاتے ہیں۔ پرائیویسی نوٹس: سرکاری ڈسٹری بیوشن بلڈز میں مجموعی اعداد و شمار کے لیے TapDB استعمال کی تجزیات شامل ہیں (ڈیوائس، OS، ایپ ورژن میٹا ڈیٹا، سائن ان کے بعد اکاؤنٹ ID سے منسلک) اور چیٹ مواد، فائل مواد یا ورکنگ ڈائریکٹری ڈیٹا جمع نہیں کرتے؛ ایک سائن ان آن لائن ہارٹ بیٹ صرف اکاؤنٹ ID، پلیٹ فارم اور ورژن بھیجتا ہے؛ کریش ڈمپس مقامی رہتے ہیں۔ سورس بلڈز تجزیات کو چھوڑ سکتی ہیں، کیونکہ موبائل TapDB اسناد کے بغیر no-op ہے اور ڈیسک ٹاپ تجزیات initTapdb() کال ہٹا کر ہٹائی جا سکتی ہیں۔ لائسنسنگ: سورس کوڈ Apache-2.0 ہے سوائے اس کے کہ جہاں بصورت دیگر نوٹ کیا گیا ہو، ماڈل ویٹس، ڈیٹاسیٹس، پرامپٹس اور ٹریڈ مارکس ممکنہ طور پر الگ شرائط کے تحت ہیں؛ تھرڈ پارٹی انتساب اور SPDX SBOMs docs/legal/ کے تحت منظم ہیں۔