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

StarNet ایک لوکل-فرسٹ ڈیسک ٹاپ ایپلیکیشن ہے جو آپ کو AI ایجنٹس بنانے، انہیں پکسل-آرٹ اسپیس اسٹیشن میں منظم کرنے، اور حقیقی ماڈلز اور ٹولز کے ذریعے حقیقی کام کرتے دیکھنے کی سہولت دیتی ہے۔ اسٹیشن محض آرائشی نہیں؛ یہ رن ٹائم حالت کا زندہ پروجیکشن ہے جہاں کمرے صلاحیت کے دائرے میں کام کرنے والی ٹیموں کی نمائندگی کرتے ہیں، راہداریاں مجاز ہینڈ آف لینز ہیں، اور رکھی گئی اشیاء حقیقی صلاحیت کے گرانٹس ہیں۔ اہم خصوصیات میں شامل ہیں: - متعدد ایجنٹس بنانا جن کی الگ کلاسز، شخصیات اور لوڈ آؤٹس ہوں، ہر ایک اپنے ورک اسپیس میں محدود اجازتوں کے ساتھ بیک وقت چلے۔ - اپنی API کیز (OpenRouter، Anthropic، OpenAI، Google) لانا جو OS کی-چین میں محفوظ طریقے سے محفوظ ہوں؛ فرنٹ اینڈ کبھی خفیہ معلومات نہیں رکھتا۔ - ایجنٹس کو Telegram، Discord، Slack، Signal، یا Matrix جیسے میسجنگ پلیٹ فارمز سے جوڑنا تاکہ دور سے تعامل ممکن ہو۔ - Ollama کے ذریعے مقامی ماڈلز استعمال کرنا، بغیر کسی API کی یا لاگت کے۔ - cron کے ساتھ ٹاسکس شیڈول کرنا، کثیر المرحل ترکیبیں چلانا، اور دوبارہ استعمال کے قابل مہارتیں دینا۔ - اندازہ لگانے کے بجائے Task Briefs کے ذریعے وضاحتی سوالات پوچھنا۔ - مکمل شدہ کام کو OUTBOX ڈائریکٹری میں حقیقی فائلوں کے طور پر پیش کرنا۔ - ایجنٹ کی صلاحیتوں کو بڑھانے کے لیے Model Context Protocol (MCP) سرورز اور پیسٹ-اے-کی/OAuth کنیکٹرز منسلک کرنا۔ - پش-ٹو-ٹاک آواز کی ڈکٹیشن اور اسٹیشن کی مستقل آواز کا آؤٹ پٹ۔ - اخراجات، بجٹ، ٹاسک کی تاریخ، اور شیڈولز کے لیے ڈسک پر مستقل لیجرز۔ آرکیٹیکچر میں ذمہ داریاں الگ کی گئی ہیں: - `frontend/`: ونیلا JavaScript اسٹیشن ورلڈ اور ڈیسک ٹاپ UI۔ - `sidecar/`: مقامی Node.js ایجنٹ رن ٹائم جو پرووائیڈرز، ٹولز، پرسسٹنس، بجٹ، اور رضامندی سنبھالتا ہے۔ - `shared/`: بین الحدود ایونٹ اور اسکیما کنٹریکٹس۔ - `src-tauri/`: Rust/Tauri ڈیسک ٹاپ شیل اور بنڈل شدہ رن ٹائم۔ - `test/` اور `qa/`: یونٹ، کنٹریکٹ، انٹیگریشن، اور ریلیز-گیٹ ٹیسٹس، نیز لائیو QA رسیدیں۔ عوامی ریلیز ٹرین Windows 10/11 (64-bit) اور macOS (Apple Silicon اور Intel) کو سپورٹ کرتی ہے۔ Linux پیکجز اندرونی بلڈ آرٹیفیکٹس ہیں اور عوامی طور پر سپورٹ شدہ ہدف نہیں۔ ڈیسک ٹاپ بلڈز GitHub ریلیزز صفحے پر شائع کی جاتی ہیں۔ سورس سے چلانے کے لیے آپ کو Node.js 18+ (Node.js 22 CI سے مطابقت رکھتا ہے)، Git، اور اختیاری طور پر ڈیسک ٹاپ شیل کے لیے Rust اور Tauri کی شرائط درکار ہیں۔ سائیڈ کار کو براہ راست `node sidecar/index.js` سے شروع کیا جا سکتا ہے، پھر براؤزر میں http://localhost:8787 کھولیں۔ ڈیولپمنٹ کے لیے `npm run desktop:dev` اور `npm run desktop:build` استعمال کریں۔ ٹیسٹنگ npm اسکرپٹس کے ذریعے کی جاتی ہے: `npm run test:fast` (لازمی مرج گیٹ)، `npm run test:http` (لائیو سائیڈ کار HTTP/E2E سوٹ)، `npm test` (مکمل توثیق)، اور `npm run security:secrets` (مکمل تاریخ کا خفیہ اسکین)۔ ریلیز کی تیاری `npm run qa:ready` سے جانچی جاتی ہے۔ شراکتیں خوش آمدید ہیں؛ CONTRIBUTING.md اور ضابطہ اخلاق دیکھیں۔ سیکیورٹی کمزوریاں SECURITY.md کے مطابق نجی طور پر رپورٹ کی جانی چاہئیں۔ یہ پروجیکٹ MIT لائسنس کے تحت اوپن سورس ہے۔ لائسنس صرف کوڈ پر لاگو ہوتا ہے؛ StarNet نام، لوگو، اسٹیشن آرٹ ورک، اور برانڈ شناخت Andrew Sims کی ملکیت ہیں اور کوڈ کے ساتھ لائسنس یافتہ نہیں۔ فورکس کو اپنا نام، لوگو، اور آرٹ ورک استعمال کرنا ہوگا اور وہ خود کو StarNet یا پروجیکٹ کی طرف سے توثیق شدہ ظاہر نہیں کر سکتے۔