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

StarNet একটি লোকাল-ফার্স্ট ডেস্কটপ অ্যাপ্লিকেশন যা আপনাকে AI এজেন্ট তৈরি করতে, সেগুলোকে পিক্সেল-আর্ট স্পেস স্টেশনে সংগঠিত করতে এবং বাস্তব মডেল ও টুল ব্যবহার করে তাদের প্রকৃত কাজ করতে দেখতে দেয়। স্টেশনটি কেবল সাজসজ্জা নয়; এটি রানটাইম অবস্থার একটি লাইভ প্রজেকশন, যেখানে রুমগুলো ক্ষমতা-সীমাবদ্ধ দলকে প্রতিনিধিত্ব করে, হলওয়ে হলো অনুমোদিত হ্যান্ডঅফ লেন এবং স্থাপিত বস্তুগুলো প্রকৃত ক্ষমতা অনুদান। মূল ক্ষমতাগুলোর মধ্যে রয়েছে: - একাধিক এজেন্ট তৈরি করা যার আলাদা শ্রেণি, পরিচয় এবং লোডআউট রয়েছে, প্রতিটি সীমিত অনুমতি নিয়ে নিজস্ব ওয়ার্কস্পেসে সমান্তরালে চলে। - নিজের API কী আনা (OpenRouter, Anthropic, OpenAI, Google) যা OS কীচেইনে নিরাপদে সংরক্ষিত থাকে; ফ্রন্টএন্ড কখনো গোপন তথ্য ধারণ করে না। - Telegram, Discord, Slack, Signal বা Matrix-এর মতো মেসেজিং প্ল্যাটফর্মে এজেন্ট সংযুক্ত করা দূরবর্তী মিথস্ক্রিয়ার জন্য। - API কী বা খরচ ছাড়াই Ollama-এর মাধ্যমে লোকাল মডেল ব্যবহার করা। - cron দিয়ে কাজ নির্ধারণ, মাল্টি-স্টেপ রেসিপি চালু এবং পুনঃব্যবহারযোগ্য দক্ষতা প্রদান। - Task Briefs-এর মাধ্যমে অনুমান না করে স্পষ্টীকরণ প্রশ্ন জিজ্ঞাসা করা। - OUTBOX ডিরেক্টরিতে প্রকৃত ফাইল হিসেবে সম্পন্ন কাজ সরবরাহ করা। - Model Context Protocol (MCP) সার্ভার এবং paste-a-key/OAuth কানেক্টর সংযুক্ত করে এজেন্ট ক্ষমতা বাড়ানো। - Push-to-talk ভয়েস ডিক্টেশন এবং সামঞ্জস্যপূর্ণ স্টেশন ভয়েস আউটপুট। - খরচ, বাজেট, কাজের ইতিহাস এবং সময়সূচির জন্য ডিস্কে স্থায়ী লেজার। স্থাপত্যটি উদ্বেগ আলাদা করে: - `frontend/`: ভ্যানিলা জাভাস্ক্রিপ্ট স্টেশন ওয়ার্ল্ড এবং ডেস্কটপ 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 এবং Code of Conduct দেখুন। নিরাপত্তা দুর্বলতা SECURITY.md অনুযায়ী ব্যক্তিগতভাবে রিপোর্ট করা উচিত। প্রকল্পটি MIT লাইসেন্সের অধীনে ওপেন সোর্স। লাইসেন্সটি কেবল কোড কভার করে; StarNet নাম, লোগো, স্টেশন আর্টওয়ার্ক এবং ব্র্যান্ড পরিচয় Andrew Sims-এর মালিকানাধীন এবং কোডের সাথে লাইসেন্সপ্রাপ্ত নয়। ফর্কগুলোকে নিজস্ব নাম, লোগো এবং আর্টওয়ার্ক ব্যবহার করতে হবে এবং নিজেদের StarNet বা প্রকল্পের অনুমোদিত হিসেবে উপস্থাপন করতে পারবে না।