OpenShell v0.1.6
Runtime sandboxé pour agents IA autonomes avec des politiques YAML déclaratives appliquant des contraintes sur le système de fichiers, le réseau et les processus, ainsi qu'une injection d'identifiants liée aux points de terminaison.
[!IMPORTANT] Nouveau dans OpenShell 0.1.x : une cadence de publication stable, de nouvelles primitives d'isolation, une surface d'extension élargie et de nouvelles API. Lire le guide de mise à niveau 0.1.0.
OpenShell est le runtime sûr et privé pour des flottes d'agents IA autonomes. Les agents sont plus utiles lorsqu'ils peuvent lire des fichiers, installer des paquets, appeler des API et utiliser des identifiants. OpenShell leur en donne la capacité sans leur accorder un accès illimité à vos données, secrets ou réseau. Vous déclarez ce que chaque agent peut toucher dans une politique, et OpenShell l'applique.
Fonctionnement
OpenShell régit ce que les agents peuvent faire de deux manières : il instrumente le noyau pour appliquer la politique à chaque accès fichier, appel système et connexion réseau à l'exécution, et il utilise la vérification formelle pour contrôler ce qu'un changement de politique autoriserait avant qu'il ne soit appliqué.
- Application au niveau du noyau. Chaque agent s'exécute dans un bac à sable isolé. Les contrôles du noyau limitent les fichiers auxquels il peut accéder et les appels système qu'il peut effectuer, et chaque connexion réseau passe par une vérification de politique avant de quitter le bac à sable. Les agents ne voient jamais les vrais identifiants ; OpenShell les ajoute uniquement aux requêtes destinées à des points de terminaison approuvés.
- Changements de politique formellement vérifiés. Avant qu'un changement de politique ne soit approuvé, OpenShell utilise la vérification formelle pour signaler les nouveaux accès risqués qu'il accorderait, comme atteindre un nouvel hôte avec des identifiants ou appeler une nouvelle méthode d'API, afin que ces changements attendent une revue humaine.
Voir Architecture pour comprendre comment la passerelle, le superviseur et le bac à sable s'articulent.
Démarrage rapide
Vous avez besoin de Linux, de macOS sur Apple Silicon, ou de Windows avec WSL 2 (expérimental), ainsi que de Docker, Podman ou de la virtualisation hôte. Voir la Matrice de prise en charge pour plus de détails.
curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create --name demo
L'installateur configure le CLI et une passerelle locale. L'image sandbox par défaut est un Ubuntu minimal sans agent installé. Pour exécuter un véritable agent, suivez Run Your First Agent : il exécute OpenCode avec un modèle OpenRouter gratuit et montre comment approuver un nouvel accès au fur et à mesure que l'agent en a besoin.
Pour la prise en charge native de Windows via Microsoft MXC, consultez le guide de compilation et d'exécution Windows pour la configuration et les limitations actuelles.
Explorer davantage
- Sandboxes : images, runtimes, GPU et cycle de vie.
- Policies : règles de système de fichiers, de réseau et de processus, avec l'advisor et le prover pour examiner les modifications.
- Providers : identifiants qui ne fonctionnent qu'aux points de terminaison approuvés, y compris l'inférence.
- Gateways : le plan de contrôle pour les sandboxes, les politiques et l'accès.
- Kubernetes : déployez la passerelle avec Helm. Votre CNI doit appliquer
NetworkPolicy. - Extensibilité : middleware, intercepteurs et pilotes de calcul.
- Tutoriels : parcours pas à pas sur les politiques et les agents.
- Builds de préversion et de développement : essayez une version à venir ou le dernier commit sur
main.
Compétences d'agent
Installez les compétences publiques OpenShell pour votre agent de codage :
npx skills add NVIDIA/OpenShell
Les skills apprennent à votre agent à piloter la CLI OpenShell, à écrire des politiques de sandbox et à déboguer les gateways et le routage d'inférence. Ils se trouvent dans skills/ et fonctionnent sans checkout du code source d'OpenShell.
SDKs
Les SDKs connectent les applications à une gateway OpenShell. Ils n'installent pas la CLI. Utilisez la même version d'OpenShell pour le SDK et la gateway lorsque c'est possible.
| Langage | Installation | Documentation |
|---|---|---|
| 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> | Installation et utilisation |
Communauté
- Questions et discussions : GitHub Discussions
- Rapports de bugs et demandes de fonctionnalités : GitHub Issues, en utilisant les modèles d'issue
- Vulnérabilités de sécurité : suivez SECURITY.md. N'ouvrez pas d'issue GitHub.
- Feuille de route : OpenShell Roadmap et le tableau RFC
- Essayez-le dans le cloud : Brev Launchable