स्वायत्त 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 दो तरीकों से नियंत्रित करता है कि एजेंट क्या कर सकते हैं: यह रनटाइम पर प्रत्येक फ़ाइल एक्सेस, सिस्टम कॉल और नेटवर्क कनेक्शन पर पॉलिसी लागू करने के लिए कर्नेल को इंस्ट्रुमेंट करता है, और यह औपचारिक सत्यापन का उपयोग करके जाँचता है कि पॉलिसी परिवर्तन लागू होने से पहले क्या अनुमति देगा।
यह देखने के लिए कि गेटवे, सुपरवाइज़र और सैंडबॉक्स एक साथ कैसे फिट होते हैं, आर्किटेक्चर देखें।
आपको 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 देखें।
NetworkPolicy लागू करना होगा।main पर नवीनतम कमिट आज़माएँ।अपने कोडिंग एजेंट के लिए सार्वजनिक OpenShell स्किल्स इंस्टॉल करें:
npx skills add NVIDIA/OpenShell
ये स्किल्स आपके एजेंट को OpenShell CLI चलाना, सैंडबॉक्स पॉलिसियाँ लिखना, और गेटवे तथा इन्फरेंस रूटिंग को डीबग करना सिखाती हैं। ये skills/ में मौजूद हैं और OpenShell सोर्स चेकआउट के बिना काम करती हैं।
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> | इंस्टॉलेशन और उपयोग |
OpenShell एजेंट-फ़र्स्ट तरीके से बनाया गया है: इसे उन्हीं एजेंट-संचालित वर्कफ़्लो के साथ विकसित किया जाता है जिन्हें यह सक्षम बनाता है। डेवलपमेंट सेटअप और योगदान वर्कफ़्लो के लिए CONTRIBUTING.md देखें, और रिपॉज़िटरी कोडिंग परंपराओं के लिए AGENTS.md देखें।