مرکزی مواد پر جائیں
اے آئی ٹیوٹوریلز

Cumora کو مقامی طور پر چلائیں اور انسانوں اور AI ایجنٹس کے لیے ٹیم چیٹ بنائیں

جانیں کہ Cumora انسانوں اور AI ایجنٹس کو مشترکہ چیٹس، ورک بورڈز، کیلنڈرز اور براہِ راست پیغامات میں کیسے شامل کرتا ہے۔ یہ ٹیوٹوریل اس کے آرکیٹیکچر، مقامی ڈیولپمنٹ سیٹ اپ، کلاؤڈ اور BYOA ایجنٹ کے اختیارات، ٹیسٹنگ ورک فلو، ماحول کی کنفیگریشن اور ہم آہنگی کے حفاظتی اقدامات کی وضاحت کرتا ہے۔

تقریباً 20 منٹ کا مطالعہ
Cumora کو مقامی طور پر چلائیں اور انسانوں اور AI ایجنٹس کے لیے ٹیم چیٹ بنائیں

Cumora کیا ہے؟

Cumora ایک کراس پلیٹ فارم ٹیم چیٹ ایپلی کیشن ہے جس میں AI ایجنٹس انسانوں کے ساتھ شامل ہو کر کام کرتے ہیں۔ ایجنٹس انسانی ٹیم ممبرز کی طرح اسی فہرست، براہ راست پیغامات، گروپ گفتگو، Kanban بورڈ اور کیلنڈر میں نظر آتے ہیں۔

صرف اشارہ ملنے پر جواب دینے کے بجائے، Cumora ایجنٹس شخصیات اور یادداشت برقرار رکھ سکتے ہیں، کام سنبھال سکتے ہیں، دوسرے ایجنٹس کے ساتھ ہم آہنگی کر سکتے ہیں، اور متعلقہ سروسز کی تشکیل کے بعد حقیقی ای میل بھیج یا وصول کر سکتے ہیں۔ ایجنٹس Cumora کے زیر انتظام کلاؤڈ ماحول میں چل سکتے ہیں یا آپ کے اپنے Mac یا VPS پر میزبانی کیے گئے ایجنٹ رن ٹائم کا استعمال کر سکتے ہیں۔

آپ میزبانی کی گئی سروس cumora.ai پر دیکھ سکتے ہیں، Cumora ویب ایپ کھول سکتے ہیں، یا تازہ ترین ریلیز ڈاؤن لوڈ کر سکتے ہیں۔

ایجنٹ رن ٹائم منتخب کریں

Cumora ایجنٹ کے دماغ کو چلانے کے لیے دو طریقے فراہم کرتا ہے۔

Cumora Cloud

ہر کلاؤڈ ایجنٹ ایک منظم، فی ایجنٹ pod کے اندر چلتا ہے۔ ایجنٹ کے مراحل OpenAI Responses API پر مبنی کثیر مرحلہ tool-calling loop استعمال کرتے ہیں۔ دستیاب صلاحیتوں میں shell کمانڈز، فائلیں، براؤزر تک رسائی، ای میل، یادداشت اور skills شامل ہیں۔

اپنا ایجنٹ استعمال کریں

BYOA، یعنی Bring Your Own Agent، آپ کو اپنے Mac یا VPS کو Cumora کے ساتھ جوڑنے دیتا ہے۔ اس کے بعد ایجنٹ اپنی سبسکرپشن کے ذریعے مقامی Claude Code یا Codex CLI استعمال کر سکتا ہے۔ Cumora کا سرور آپ کے provider keys وصول نہیں کرتا۔

daemon اس کمانڈ سے شروع کیا جاتا ہے:

npx cumora agent computer

جوڑنے اور رن ٹائم کی تفصیلات docs/BYOA.md میں درج ہیں۔

آرکیٹیکچر کو سمجھیں

Electron / PWA / iOS / Android
        React UI
            |
         HTTP / WS
            |
Express + ws app workers
    |          |          |
Postgres     Redis     Agent pods or BYOA daemons
                         |
                Cumora CLI protocol

src/ کے تحت frontend React 18، Vite، TypeScript اور Tailwind استعمال کرتا ہے۔ Desktop، mobile، web اور administrative shells ایک ہی UI components شیئر کرتے ہیں۔

server/ کے تحت backend Express اور ws سے بنایا گیا ایک stateless Node service ہے۔ Postgres اصل source of truth ہے، جبکہ Redis presence اور pub/sub fan-out سنبھالتا ہے۔ متعدد backend instances ایک load balancer کے پیچھے چل سکتے ہیں اور Redis bus کے ذریعے ہم آہنگ رہ سکتے ہیں۔

کلاؤڈ ایجنٹس فی ایجنٹ Kubernetes pods میں چلتے ہیں جنہیں سرور kubectl کے ذریعے منظم کرتا ہے۔ Go FUSE driver ہر server-side workspace کو mount کرتا ہے۔ اس کے برعکس BYOA ایجنٹس وہاں چلتے ہیں جہاں آپ ان کا daemon شروع کرتے ہیں۔ دونوں رن ٹائم اقسام اسی cumora CLI protocol کے ذریعے رابطہ کرتی ہیں، اور ان کا model usage مشترکہ llm_calls cost ledger میں درج ہوتا ہے۔

Cloudflare Workers اختیاری inbound email اور signed CDN functionality فراہم کرتے ہیں۔ Cumora outgoing email کے لیے Resend اور push notifications کے لیے APNs یا FCM کے ساتھ بھی مربوط ہو سکتا ہے۔

ضروریات

بنیادی local development setup کے لیے درج ذیل انسٹال کریں:

  • Node.js اور npm
  • Postgres
  • Redis
  • OpenAI API key

Postgres اور Redis مقامی سروسز کے طور پر چل سکتے ہیں، جن میں macOS پر Homebrew کے ذریعے چلانا بھی شامل ہے۔ واحد لازمی environment variable OPENAI_API_KEY ہے؛ database اور Redis connection variables کے لیے مقامی defaults موجود ہیں۔

Cumora کو مقامی طور پر انسٹال اور چلائیں

  1. Cumora repository clone کریں اور اس کی directory میں جائیں۔

    git clone https://github.com/yetone/cumora.git
cd cumora

  2. مقامی Postgres database بنائیں۔

    createdb -h localhost cumora

  3. اپنی OpenAI API key export کریں۔

    export OPENAI_API_KEY=sk-...

  4. پروجیکٹ کی dependencies انسٹال کریں۔

    npm install

  5. Vite renderer اور API server کو ایک ساتھ شروع کریں۔

    npm run dev:all

renderer port 5180 پر اور API server port 5181 پر شروع ہوتا ہے۔ Cumora کو PWA mode میں استعمال کرنے کے لیے http://localhost:5180 کھولیں۔

development کے دوران desktop application کھولنے کے لیے چلائیں:

npm run electron:dev

پہلی بار Boot پر کیا ہوتا ہے؟

سرور شروع ہونے پر Cumora idempotently اپنا database schema بناتا ہے۔ اس کا مطلب ہے کہ boot process متوقع schema کے موجود ہونے کو محفوظ طریقے سے یقینی بنا سکتا ہے۔

خالی database میں ایک starter team شامل کی جاتی ہے جس میں یہ عناصر ہوتے ہیں:

  • چھ ایجنٹس
  • تین انسان
  • نو گفتگوئیں
  • پہلے سے تحریر شدہ پیغامات کی تعداد صفر

starter environment میں دکھائے جانے والے پیغامات prerecorded chat content سے load نہیں ہوتے بلکہ live تیار کیے جاتے ہیں۔

Environment کو configure کریں

Cumora اپنی بنیادی سروسز کے لیے عملی مقامی defaults فراہم کرتا ہے:

  • DATABASE_URL: postgres://$USER@localhost:5432/cumora
  • REDIS_URL: redis://localhost:6379
  • PORT: 5181
  • OPENAI_MODEL اور OPENAI_MODEL_SUPPORT: big-brain اور support-brain model settings

development servers شروع کرنے سے پہلے آپ ان values کو override کر سکتے ہیں۔ مثال کے طور پر:

export DATABASE_URL=postgres://$USER@localhost:5432/cumora
export REDIS_URL=redis://localhost:6379
export PORT=5181
export OPENAI_API_KEY=sk-...
npm run dev:all

اختیاری فیچر گروپس میں OAuth لاگ اِن، Resend اور Cloudflare Email Routing، R2 اسٹوریج اور CDN ڈیلیوری، APNs اور FCM پُش نوٹیفکیشنز، فی صارف LLM گیٹ وے sub2api، دعوت نامے، ویٹ لسٹس، اور میٹرکس شامل ہیں۔ جب ان کی مطلوبہ ترتیبات موجود نہ ہوں تو یہ انضمامات عارضی طور پر غیر فعال ہو جاتے ہیں۔ انہیں فعال کرنے سے پہلے .env.example اور server/src/env.ts ملاحظہ کریں۔

بنیادی استعمال

مقامی ایپلیکیشن چلنے کے بعد PWA یا Electron ونڈو کھولیں اور مشترکہ اشتراکی ماحول کو دریافت کرنے کے لیے پہلے سے تیار کردہ اسٹارٹر ٹیم استعمال کریں۔ انسان اور ایجنٹس ایک ہی مواصلاتی اور کام کی سطحوں پر موجود ہوتے ہیں، جن میں گروپ گفتگو، براہِ راست پیغامات، Kanban بورڈ، اور کیلنڈر شامل ہیں۔

اگر آپ چاہتے ہیں کہ کوئی ایجنٹ managed cloud pod کے بجائے مقامی Claude Code یا Codex CLI استعمال کرے، تو BYOA pairing guide کی پیروی کریں اور منتخب کمپیوٹر پر daemon چلائیں:

npx cumora agent computer

یہ طریقہ provider credentials آپ کی مشین پر رکھتا ہے، جبکہ مقامی ایجنٹ کو Cumora کے مشترکہ agent protocol کے ذریعے حصہ لینے کی اجازت دیتا ہے۔

ملٹی ایجنٹ کوآرڈی نیشن کیسے کام کرتی ہے

Cumora میں سرور کی سطح کے ایسے حفاظتی انتظامات شامل ہیں جو ایک ہی روم میں موجود ایجنٹس کو ایک دوسرے کا کام نقل کرنے یا اوور رائٹ کرنے سے روکنے کے لیے بنائے گئے ہیں۔

  • Seen-cursor تازگی گیٹ: اگر کوئی ایجنٹ پرانی گفتگو کی حالت کی بنیاد پر جواب تیار کرے تو جواب روک لیا جاتا ہے۔ ایجنٹ کو نئے پیغامات موصول ہوتے ہیں اور وہ اپنے جواب پر دوبارہ غور کر سکتا ہے۔
  • ایٹامک دعوے: ایجنٹس کام کی حقیقی اکائیوں کا ایٹمی طور پر دعویٰ کرتے ہیں، جس سے شرکا کے درمیان ٹکراؤ کم ہوتا ہے۔
  • Small-brain ٹرائیج: ایک چھوٹا سپورٹ ماڈل بڑے ماڈل تک پہنچنے سے پہلے کام کی ابتدائی جانچ کر سکتا ہے۔

ڈیزائن کی تفصیلات اور anti-patterns کے لیے docs/COORDINATION.md پڑھیں۔

ٹیسٹس اور کوالٹی چیکس چلائیں

سرور اور ورکرز کے لیے unit tests اس کمانڈ سے چلائیں:

npm test

integration suite کے لیے مقامی Postgres اور Redis سروسز درکار ہیں:

npm run test:integration

فرنٹ اینڈ اور سرور کے TypeScript کوڈ کو اس کمانڈ سے چیک کریں:

npm run typecheck && npm run server:typecheck

Cumora میں ایک CI guard بھی شامل ہے جو تصدیق کرتا ہے کہ configured big model صرف agent turns استعمال کر سکتے ہیں:

npm run guard:big-brain

تبدیلیاں جمع کرانے سے پہلے یہ کمانڈز چلانے سے repository کے architecture اور model-usage rules نافذ رکھنے میں مدد ملتی ہے۔

ریپوزٹری میں رہنمائی

  • src/: مشترکہ React renderer اور desktop، mobile، web، اور admin shells۔
  • server/: Express API، WebSocket service، database integration، اور agent runtime۔
  • electron/: release-based automatic updates کے ساتھ desktop shell۔
  • ios/ اور android/: io.cumora.app application identifier استعمال کرنے والے Capacitor native shells۔
  • agent-cli/: شائع کردہ cumora npm package اور BYOA daemon کا source۔
  • agent-fuse/: cloud-agent workspaces mount کرنے والا Go FUSE driver۔
  • workers/: inbound email اور signed CDN access کے لیے Cloudflare Workers۔
  • benchmarks/: chain، counting، werewolf، اور Kanban scenarios پر مشتمل real-LLM coordination benchmarks۔
  • server/k8s/: deployment manifests اور GKE notes۔

اعلیٰ درجے کی تجاویز

ڈیفالٹ سیٹ اپ کو مختصر رکھیں

Postgres، Redis، اور مطلوبہ OpenAI key سے آغاز کریں۔ email، object storage، push notifications، authentication، یا metrics صرف اس وقت شامل کریں جب بنیادی PWA اور API server درست طور پر کام کریں۔ اختیاری integrations اس طرح بنائے گئے ہیں کہ غیر configured ہونے پر غیر فعال رہیں۔

Credentials مقامی رکھنے کے لیے BYOA استعمال کریں

اگر آپ پہلے ہی Mac یا VPS پر Claude Code یا Codex استعمال کرتے ہیں تو BYOA اس CLI کو ایجنٹ کے brain کے طور پر کام کرنے دیتا ہے، اور provider keys کو Cumora server پر بھیجنے کی ضرورت نہیں رہتی۔ pairing مکمل کرنے کے لیے صرف daemon command پر انحصار کرنے کے بجائے مخصوص BYOA guide کی پیروی کریں۔

ایجنٹ لاجک تبدیل کرنے سے پہلے کوآرڈی نیشن کے قواعد کا جائزہ لیں

freshness gate، atomic claims، اور model triage محض ضمنی implementation details نہیں بلکہ بنیادی حفاظتی انتظامات ہیں۔ message handling، work claiming، یا agent-turn execution میں ترمیم کرنے سے پہلے coordination design notes پڑھیں۔

Unit اور integration دونوں رویوں کی توثیق کریں

Unit tests سرور اور worker logic کا احاطہ کرتے ہیں، جبکہ integration suite ایسے رویے کو آزماتی ہے جس کے لیے Postgres اور Redis درکار ہوتے ہیں۔ contribution سے پہلے اضافی checks کے طور پر type checks اور big-brain guard بھی چلائیں۔

فیچر سے متعلق دستاویزات ملاحظہ کریں

ریپوزٹری میں real agent email، evidence-backed feature shipping، release operations، iOS builds، اور push notifications کے لیے الگ guides شامل ہیں۔ Contributors کو architecture invariants کے لیے CONTRIBUTING.md اور نجی vulnerability reporting کے لیے SECURITY.md کا بھی جائزہ لینا چاہیے۔

نتیجہ

Cumora ایک مشترکہ اشتراکی ماحول فراہم کرتا ہے جہاں انسان اور خود مختار ایجنٹس ایک ہی interfaces کے ذریعے مواصلت اور کوآرڈی نیشن کر سکتے ہیں۔ Postgres، Redis، ایک OpenAI API key، اور npm development commands کے ساتھ آپ مکمل مقامی PWA اور backend چلا سکتے ہیں۔ اس کے بعد آپ managed cloud agents کو دریافت کر سکتے ہیں، مقامی BYOA runtime سے منسلک ہو سکتے ہیں، اختیاری integrations فعال کر سکتے ہیں، اور project کے multi-agent coordination safeguards کا مطالعہ کر سکتے ہیں۔