
OpenShell v0.1.5
स्वायत्त AI एजेंट्स के लिए सैंडबॉक्स्ड रनटाइम, जिसमें फाइलसिस्टम, नेटवर्क और प्रोसेस बाधाओं को लागू करने वाली डिक्लेरेटिव YAML नीतियाँ, साथ ही एंडपॉइंट-बाउंड क्रेडेंशियल इंजेक्शन शामिल है।
[!NOTE] 🚧 OpenShell अब CNCF का हिस्सा है! हम विकास को ai-openshell में और शासन को CNCF को स्थानांतरित करने की प्रक्रिया में हैं। स्थानांतरण पूरा होने तक, कृपया कोड, इश्यू और पुल रिक्वेस्ट के लिए NVIDIA/OpenShell रेपो का उपयोग जारी रखें।
[!IMPORTANT] OpenShell 0.1.x में नया: एक स्थिर रिलीज़ कैडेंस, नए आइसोलेशन प्रिमिटिव, एक विस्तारित एक्सटेंशन सरफेस, और नए API। 0.1.0 अपग्रेड गाइड पढ़ें।
OpenShell स्वायत्त AI एजेंटों के फ्लीट के लिए सुरक्षित, निजी रनटाइम है। एजेंट तब सबसे उपयोगी होते हैं जब वे फ़ाइलें पढ़ सकते हैं, पैकेज इंस्टॉल कर सकते हैं, API कॉल कर सकते हैं, और क्रेडेंशियल का उपयोग कर सकते हैं। OpenShell उन्हें यह क्षमता देता है, बिना आपके डेटा, सीक्रेट्स या नेटवर्क तक अप्रतिबंधित पहुँच दिए। आप एक पॉलिसी में घोषित करते हैं कि प्रत्येक एजेंट क्या छू सकता है, और OpenShell उसे लागू करता है।
यह कैसे काम करता है
OpenShell दो तरीकों से नियंत्रित करता है कि एजेंट क्या कर सकते हैं: यह रनटाइम पर प्रत्येक फ़ाइल एक्सेस, सिस्टम कॉल और नेटवर्क कनेक्शन पर पॉलिसी लागू करने के लिए कर्नेल को इंस्ट्रुमेंट करता है, और यह औपचारिक सत्यापन का उपयोग करके जाँचता है कि पॉलिसी परिवर्तन लागू होने से पहले क्या अनुमति देगा।
- कर्नेल-स्तरीय प्रवर्तन। प्रत्येक एजेंट एक पृथक सैंडबॉक्स में चलता है। कर्नेल नियंत्रण सीमित करते हैं कि यह किन फ़ाइलों तक पहुँच सकता है और कौन से सिस्टम कॉल कर सकता है, और प्रत्येक नेटवर्क कनेक्शन सैंडबॉक्स से बाहर निकलने से पहले एक पॉलिसी जाँच से गुज़रता है। एजेंट कभी वास्तविक क्रेडेंशियल नहीं देखते; OpenShell उन्हें केवल स्वीकृत एंडपॉइंट्स के लिए भेजे जाने वाले अनुरोधों में जोड़ता है।
- औपचारिक रूप से सत्यापित पॉलिसी परिवर्तन। पॉलिसी परिवर्तन स्वीकृत होने से पहले, OpenShell औपचारिक सत्यापन का उपयोग करके उन जोखिम भरे नए एक्सेस को चिह्नित करता है जो यह प्रदान करेगा, जैसे क्रेडेंशियल के साथ किसी नए होस्ट तक पहुँचना या किसी नए API मेथड को कॉल करना, ताकि वे परिवर्तन मानवीय समीक्षा की प्रतीक्षा करें।
यह देखने के लिए कि गेटवे, सुपरवाइज़र और सैंडबॉक्स एक साथ कैसे फिट होते हैं, आर्किटेक्चर देखें।
क्विकस्टार्ट
आपको Linux, Apple Silicon पर macOS, या WSL 2 के साथ Windows (प्रयोगात्मक) की आवश्यकता है, साथ ही Docker, Podman, या होस्ट वर्चुअलाइज़ेशन। विवरण के लिए सपोर्ट मैट्रिक्स देखें।
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
SDK एप्लिकेशन को OpenShell गेटवे से जोड़ते हैं। ये CLI इंस्टॉल नहीं करते। जब संभव हो, SDK और गेटवे के लिए एक ही OpenShell रिलीज़ का उपयोग करें।
| भाषा | इंस्टॉल | दस्तावेज़ |
|---|---|---|
| Python | uv add openshell | README |
| TypeScript | npm install @nvidia/openshell-sdk (GitHub Packages) | README |
| Go | go get github.com/ai-openshell/[email protected] | ai-openshell/sdk-go |
| 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 देखें।