OpenShell v0.1.6

[!IMPORTANT] OpenShell 0.1.x में नया: एक स्थिर रिलीज़ कैडेंस, नए आइसोलेशन प्रिमिटिव, एक विस्तारित एक्सटेंशन सरफेस, और नए API। 0.1.0 अपग्रेड गाइड पढ़ें।

OpenShell स्वायत्त AI एजेंटों के फ्लीट के लिए सुरक्षित, निजी रनटाइम है। एजेंट तब सबसे उपयोगी होते हैं जब वे फ़ाइलें पढ़ सकें, पैकेज इंस्टॉल कर सकें, API कॉल कर सकें और क्रेडेंशियल का उपयोग कर सकें। OpenShell उन्हें यह क्षमता देता है, बिना आपके डेटा, सीक्रेट्स या नेटवर्क तक अप्रतिबंधित पहुँच दिए। आप एक पॉलिसी में घोषित करते हैं कि प्रत्येक एजेंट क्या छू सकता है, और OpenShell उसे लागू करता है।

यह कैसे काम करता है

OpenShell दो तरीकों से नियंत्रित करता है कि एजेंट क्या कर सकते हैं: यह रनटाइम पर प्रत्येक फ़ाइल एक्सेस, सिस्टम कॉल और नेटवर्क कनेक्शन पर पॉलिसी लागू करने के लिए कर्नेल को इंस्ट्रुमेंट करता है, और यह औपचारिक सत्यापन का उपयोग करके जाँचता है कि पॉलिसी परिवर्तन लागू होने से पहले क्या अनुमति देगा।

कर्नेल-स्तरीय प्रवर्तन। प्रत्येक एजेंट एक पृथक सैंडबॉक्स में चलता है। कर्नेल नियंत्रण सीमित करते हैं कि यह किन फ़ाइलों तक पहुँच सकता है और कौन से सिस्टम कॉल कर सकता है, और प्रत्येक नेटवर्क कनेक्शन सैंडबॉक्स से बाहर निकलने से पहले एक पॉलिसी जाँच से गुज़रता है। एजेंट कभी वास्तविक क्रेडेंशियल नहीं देखते; OpenShell उन्हें केवल स्वीकृत एंडपॉइंट्स के लिए भेजे जाने वाले अनुरोधों में जोड़ता है।
औपचारिक रूप से सत्यापित पॉलिसी परिवर्तन। किसी पॉलिसी परिवर्तन को स्वीकृत करने से पहले, OpenShell औपचारिक सत्यापन का उपयोग करके उस जोखिम भरी नई पहुँच को चिह्नित करता है जो यह प्रदान करेगा, जैसे क्रेडेंशियल के साथ किसी नए होस्ट तक पहुँचना या किसी नए API मेथड को कॉल करना, ताकि वे परिवर्तन मानवीय समीक्षा की प्रतीक्षा करें।

देखें Architecture कि गेटवे, सुपरवाइज़र और सैंडबॉक्स एक साथ कैसे काम करते हैं।

क्विकस्टार्ट

आपको Linux, Apple Silicon पर macOS, या WSL 2 के साथ Windows (प्रयोगात्मक) की आवश्यकता है, साथ ही Docker, Podman, या होस्ट वर्चुअलाइज़ेशन। विवरण के लिए Support Matrix देखें।

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create --name demo

इंस्टॉलर CLI और एक स्थानीय गेटवे सेट करता है। डिफ़ॉल्ट सैंडबॉक्स इमेज न्यूनतम Ubuntu है जिसमें कोई एजेंट इंस्टॉल नहीं है। वास्तविक एजेंट चलाने के लिए, Run Your First Agent का पालन करें: यह एक मुफ़्त OpenRouter मॉडल के विरुद्ध OpenCode चलाता है और दिखाता है कि एजेंट को आवश्यकता पड़ने पर नई पहुँच को कैसे स्वीकृत किया जाए।

Microsoft MXC के माध्यम से मूल Windows समर्थन के लिए, सेटअप और वर्तमान सीमाओं के लिए Windows build and runtime guide देखें।

आगे और जानें

Sandboxes: इमेज, रनटाइम, GPU, और लाइफ़साइकल।
Policies: फ़ाइलसिस्टम, नेटवर्क, और प्रोसेस नियम, परिवर्तनों की समीक्षा के लिए advisor और prover के साथ।
Providers: ऐसे क्रेडेंशियल जो केवल स्वीकृत एंडपॉइंट्स पर काम करते हैं, जिनमें inference शामिल है।
Gateways: सैंडबॉक्स, पॉलिसी, और पहुँच के लिए कंट्रोल प्लेन।
Kubernetes: Helm के साथ गेटवे डिप्लॉय करें। आपके CNI को NetworkPolicy लागू करना होगा।
Extensibility: मिडलवेयर, इंटरसेप्टर, और कंप्यूट ड्राइवर।
Tutorials: चरण-दर-चरण पॉलिसी और एजेंट वॉकथ्रू।
Prerelease and development builds: आगामी रिलीज़ या main पर नवीनतम कमिट आज़माएँ।

Agent Skills

अपने कोडिंग एजेंट के लिए सार्वजनिक OpenShell स्किल्स इंस्टॉल करें:

npx skills add NVIDIA/OpenShell

ये स्किल्स आपके एजेंट को OpenShell CLI चलाना, सैंडबॉक्स पॉलिसियाँ लिखना, और गेटवे तथा इन्फरेंस रूटिंग को डीबग करना सिखाती हैं। ये skills/ में मौजूद हैं और OpenShell सोर्स चेकआउट के बिना काम करती हैं।

SDKs

SDKs एप्लिकेशन को OpenShell गेटवे से जोड़ते हैं। ये CLI इंस्टॉल नहीं करते। जब संभव हो, SDK और गेटवे के लिए एक ही OpenShell रिलीज़ का उपयोग करें।

भाषा	इंस्टॉल	दस्तावेज़
Python	`uv add openshell`	README
TypeScript	`npm install @nvidia/openshell-sdk` (GitHub Packages)	README
Go	`go get github.com/NVIDIA/OpenShell/sdk/go@latest`	README
Rust	`cargo add openshell-sdk --git https://github.com/NVIDIA/OpenShell --tag <release-tag>`	इंस्टॉलेशन और उपयोग

समुदाय

प्रश्न और चर्चा: GitHub Discussions
बग रिपोर्ट और फ़ीचर अनुरोध: GitHub Issues, issue टेम्पलेट्स का उपयोग करते हुए
सुरक्षा भेद्यताएँ: SECURITY.md का पालन करें। GitHub issue न खोलें।
रोडमैप: OpenShell Roadmap और RFC बोर्ड
क्लाउड में आज़माएँ: Brev Launchable

OpenShell एजेंट-फ़र्स्ट तरीके से बनाया गया है: इसे उन्हीं एजेंट-संचालित वर्कफ़्लो के साथ विकसित किया जाता है जिन्हें यह सक्षम बनाता है। डेवलपमेंट सेटअप और योगदान वर्कफ़्लो के लिए CONTRIBUTING.md देखें, और रिपॉज़िटरी कोडिंग परंपराओं के लिए AGENTS.md देखें।