स्वायत्त AI एजेंट्स के लिए सैंडबॉक्स्ड रनटाइम, जिसमें फाइलसिस्टम, नेटवर्क और प्रोसेस बाधाओं को लागू करने वाली डिक्लेरेटिव YAML नीतियाँ, साथ ही एंडपॉइंट-बाउंड क्रेडेंशियल इंजेक्शन शामिल है।
<!-- markdownlint-disable MD033 MD041 --> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/brand/assets/openshell-banner-dark.png"> <source media="(prefers-color-scheme: light)" srcset="docs/brand/assets/openshell-banner-light.png"> <img alt="OpenShell" src="https://assets.kitploit.com/production/public/readmes/55422/c804e19d2b22bb79cb299fe8da06482346c588c833ad4342ea6668f7e4f1ec6e/224fe7d3f9d8bb5110e1543695d8e28bdf42ef37ce269e338709d8ea6f94fa6e-display-v1.webp" width="430"> </picture> <!-- markdownlint-enable MD033 MD041 --> [](https://github.com/NVIDIA/OpenShell/blob/main/LICENSE) [](https://pypi.org/project/openshell/) [](SECURITY.md) [](https://docs.nvidia.com/openshell/latest/index.html) > [!IMPORTANT] > **OpenShell 0.1.x में नया:** एक स्थिर रिलीज़ कैडेंस, नए आइसोलेशन प्रिमिटिव, एक विस्तारित एक्सटेंशन सरफेस, और नए API। [0.1.0 अपग्रेड गाइड पढ़ें](https://docs.nvidia.com/openshell/latest/upgrade/0-1-0)। OpenShell स्वायत्त AI एजेंटों के फ्लीट के लिए सुरक्षित, निजी रनटाइम है। एजेंट तब सबसे उपयोगी होते हैं जब वे फ़ाइलें पढ़ सकते हैं, पैकेज इंस्टॉल कर सकते हैं, API कॉल कर सकते हैं, और क्रेडेंशियल्स का उपयोग कर सकते हैं। OpenShell उन्हें यह क्षमता देता है, बिना आपके डेटा, सीक्रेट्स, या नेटवर्क तक अप्रतिबंधित पहुँच दिए। आप एक पॉलिसी में घोषित करते हैं कि प्रत्येक एजेंट क्या छू सकता है, और OpenShell इसे लागू करता है। ## यह कैसे काम करता है OpenShell दो तरीकों से नियंत्रित करता है कि एजेंट क्या कर सकते हैं: यह रनटाइम पर प्रत्येक फ़ाइल एक्सेस, सिस्टम कॉल, और नेटवर्क कनेक्शन पर पॉलिसी लागू करने के लिए कर्नेल को इंस्ट्रुमेंट करता है, और यह औपचारिक सत्यापन का उपयोग करके जाँचता है कि पॉलिसी परिवर्तन लागू होने से पहले क्या अनुमति देगा। - **कर्नेल-स्तरीय प्रवर्तन।** प्रत्येक एजेंट एक पृथक सैंडबॉक्स में चलता है। कर्नेल नियंत्रण सीमित करते हैं कि यह किन फ़ाइलों तक पहुँच सकता है और कौन से सिस्टम कॉल कर सकता है, और प्रत्येक नेटवर्क कनेक्शन सैंडबॉक्स छोड़ने से पहले एक पॉलिसी जाँच से गुज़रता है। एजेंट कभी वास्तविक क्रेडेंशियल्स नहीं देखते; OpenShell उन्हें केवल अनुमोदित एंडपॉइंट्स के लिए बाध्य अनुरोधों में जोड़ता है। - **औपचारिक रूप से सत्यापित पॉलिसी परिवर्तन।** पॉलिसी परिवर्तन को मंज़ूरी देने से पहले, OpenShell औपचारिक सत्यापन का उपयोग करके जोखिम भरे नए एक्सेस को चिह्नित करता है जो यह प्रदान करेगा, जैसे क्रेडेंशियल्स के साथ एक नए होस्ट तक पहुँचना या एक नई API विधि को कॉल करना, ताकि वे परिवर्तन मानवीय समीक्षा की प्रतीक्षा करें। यह देखने के लिए कि गेटवे, सुपरवाइज़र, और सैंडबॉक्स एक साथ कैसे फिट होते हैं, [आर्किटेक्चर](https://docs.nvidia.com/openshell/latest/about/architecture) देखें। ## क्विकस्टार्ट आपको Linux, Apple Silicon पर macOS, या WSL 2 (प्रायोगिक) के साथ Windows, साथ ही Docker, Podman, या होस्ट वर्चुअलाइज़ेशन की आवश्यकता है। विवरण के लिए [सपोर्ट मैट्रिक्स](https://docs.nvidia.com/openshell/latest/about/support-matrix) देखें। ```shell curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh openshell sandbox create --name demo ``` इंस्टॉलर CLI और एक स्थानीय गेटवे सेट करता है। डिफ़ॉल्ट सैंडबॉक्स इमेज न्यूनतम Ubuntu है जिसमें कोई एजेंट इंस्टॉल नहीं है। एक वास्तविक एजेंट चलाने के लिए, [अपना पहला एजेंट चलाएँ](https://docs.nvidia.com/openshell/latest/about/run-your-first-agent) का पालन करें: यह एक मुफ़्त OpenRouter मॉडल के विरुद्ध OpenCode चलाता है और दिखाता है कि एजेंट को आवश्यकता पड़ने पर नए एक्सेस को कैसे अनुमोदित किया जाए। ## आगे और जानें - [सैंडबॉक्स](https://docs.nvidia.com/openshell/latest/how-it-works/sandboxes/overview): इमेज, रनटाइम, GPU, और लाइफसाइकल। - [पॉलिसी](https://docs.nvidia.com/openshell/latest/how-it-works/policies/overview): फ़ाइलसिस्टम, नेटवर्क, और प्रोसेस नियम, परिवर्तनों की समीक्षा के लिए [advisor](https://docs.nvidia.com/openshell/latest/how-it-works/policies/advisor) और [prover](https://docs.nvidia.com/openshell/latest/how-it-works/policies/prover) के साथ। - [प्रोवाइडर](https://docs.nvidia.com/openshell/latest/how-it-works/providers/overview): क्रेडेंशियल्स जो केवल अनुमोदित एंडपॉइंट्स पर काम करते हैं, जिसमें [inference](https://docs.nvidia.com/openshell/latest/how-it-works/inference) शामिल है। - [गेटवे](https://docs.nvidia.com/openshell/latest/how-it-works/gateways/overview): सैंडबॉक्स, पॉलिसी, और एक्सेस के लिए कंट्रोल प्लेन। - [Kubernetes](https://docs.nvidia.com/openshell/latest/kubernetes/setup): Helm के साथ गेटवे डिप्लॉय करें। आपके CNI को `NetworkPolicy` लागू करना चाहिए। - [एक्सटेंसिबिलिटी](https://docs.nvidia.com/openshell/latest/extensibility/overview): मिडलवेयर, इंटरसेप्टर, और कंप्यूट ड्राइवर। - [ट्यूटोरियल](https://docs.nvidia.com/openshell/latest/tutorials/first-network-policy): चरण-दर-चरण पॉलिसी और एजेंट वॉकथ्रू। - [प्रीरिलीज़ और डेवलपमेंट बिल्ड](https://docs.nvidia.com/openshell/latest/about/installation#prerelease-and-development-builds): आने वाली रिलीज़ या `main` पर नवीनतम कमिट आज़माएँ। ## एजेंट स्किल्स अपने कोडिंग एजेंट के लिए सार्वजनिक OpenShell स्किल्स इंस्टॉल करें: ```shell npx skills add NVIDIA/OpenShell ``` स्किल्स आपके एजेंट को OpenShell CLI चलाना, सैंडबॉक्स पॉलिसी लिखना, और गेटवे और inference रूटिंग को डीबग करना सिखाती हैं। वे [`skills/`](https://github.com/nvidia/openshell/blob/main/skills) में रहती हैं और OpenShell सोर्स चेकआउट के बिना काम करती हैं। ## SDKs SDKs एप्लिकेशन को एक OpenShell गेटवे से जोड़ते हैं। वे CLI इंस्टॉल नहीं करते। जब संभव हो, SDK और गेटवे के लिए समान OpenShell रिलीज़ का उपयोग करें। | भाषा | इंस्टॉल | डॉक्स | |---|---|---| | Python | `uv add openshell` | [README](https://github.com/nvidia/openshell/blob/main/python/openshell) | | TypeScript | `npm install @nvidia/openshell-sdk` (GitHub Packages) | [README](https://github.com/nvidia/openshell/blob/main/sdk/typescript/README.md) | | Go | `go get github.com/NVIDIA/OpenShell/sdk/go@latest` | [README](https://github.com/nvidia/openshell/blob/main/sdk/go/README.md) | | Rust | `cargo add openshell-sdk --git https://github.com/NVIDIA/OpenShell --tag <release-tag>` | [इंस्टॉलेशन और उपयोग](https://github.com/nvidia/openshell/blob/main/docs/sdk/rust.mdx) | ## समुदाय - **प्रश्न और चर्चा:** [GitHub Discussions](https://github.com/NVIDIA/OpenShell/discussions) - **बग रिपोर्ट और फ़ीचर अनुरोध:** [GitHub Issues](https://github.com/NVIDIA/OpenShell/issues), issue टेम्पलेट्स का उपयोग करते हुए - **सुरक्षा कमज़ोरियाँ:** [SECURITY.md](https://github.com/nvidia/openshell/blob/main/SECURITY.md) का पालन करें। GitHub issue न खोलें। - **रोडमैप:** [OpenShell Roadmap](https://github.com/orgs/NVIDIA/projects/233) और [RFC बोर्ड](https://github.com/orgs/NVIDIA/projects/233/views/6) - **क्लाउड में आज़माएँ:** [Brev Launchable](https://brev.nvidia.com/launchable/deploy/now?launchableID=env-3Ap3tL55zq4a8kew1AuW0FpSLsg) OpenShell एजेंट-फर्स्ट बनाया गया है: यह उन्हीं एजेंट-संचालित वर्कफ़्लो के साथ विकसित किया जाता है जिन्हें यह सक्षम बनाता है। डेवलपमेंट सेटअप और योगदान वर्कफ़्लो के लिए [CONTRIBUTING.md](https://github.com/nvidia/openshell/blob/main/CONTRIBUTING.md) देखें, और रिपॉज़िटरी कोडिंग कन्वेंशन के लिए [AGENTS.md](https://github.com/nvidia/openshell/blob/main/AGENTS.md) देखें। ## टेलीमेट्री OpenShell परियोजना को बेहतर बनाने में मदद के लिए अनाम टेलीमेट्री एकत्र करता है, जो परिचालन श्रेणियों और गणनाओं तक सीमित है। यह सैंडबॉक्स नाम, होस्टनाम, फ़ाइल पथ, प्रॉम्प्ट, क्रेडेंशियल्स, प्रोवाइडर या मॉडल नाम, या उपयोगकर्ता सामग्री एकत्र नहीं करता। इसे अक्षम करने के लिए, गेटवे पर `OPENSHELL_TELEMETRY_ENABLED=false` सेट करें, या Helm इंस्टॉल के लिए `server.telemetryEnabled=false` सेट करें। आप टेलीमेट्री को पूरी तरह से कंपाइल आउट भी कर सकते हैं। विवरण के लिए [टेलीमेट्री](https://docs.nvidia.com/openshell/latest/observability/telemetry) देखें और प्रकाशित उपयोग रुझानों के लिए [समुदाय टेलीमेट्री रिपोर्ट](https://github.com/nvidia/openshell/blob/main/telemetry/README.md) देखें। ## सूचना और अस्वीकरण यह सॉफ़्टवेयर स्वचालित रूप से बाहरी सामग्री को पुनःप्राप्त करता है, एक्सेस करता है या उसके साथ इंटरैक्ट करता है। वे पुनःप्राप्त सामग्री इस सॉफ़्टवेयर के साथ वितरित नहीं की जाती है और पूरी तरह से अलग शर्तों, नियमों और लाइसेंसों द्वारा शासित होती है। सभी लागू शर्तों, नियमों, और लाइसेंसों को खोजना, समीक्षा करना और उनका पालन करना, और आपके विशिष्ट उपयोग केस के लिए किसी भी पुनःप्राप्त सामग्री की सुरक्षा, अखंडता और उपयुक्तता को सत्यापित करना पूरी तरह से आपकी ज़िम्मेदारी है। यह सॉफ़्टवेयर "जैसा है" प्रदान किया गया है, किसी भी प्रकार की वारंटी के बिना। लेखक किसी भी पुनःप्राप्त सामग्री के संबंध में कोई प्रतिनिधित्व या वारंटी नहीं देता है, और इस सॉफ़्टवेयर या किसी भी पुनःप्राप्त सामग्री के आपके उपयोग या उपयोग करने में असमर्थता से होने वाले किसी भी नुकसान, क्षति, दायित्व या कानूनी परिणामों के लिए कोई दायित्व नहीं मानता है। इस सॉफ़्टवेयर और पुनःप्राप्त सामग्री का उपयोग अपने जोखिम पर करें। ## लाइसेंस यह परियोजना [Apache License 2.0](https://github.com/NVIDIA/OpenShell/blob/main/LICENSE) के अंतर्गत लाइसेंस प्राप्त है।
