OpenShell

[!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. Consultez 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 donne cette 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 la CLI et une passerelle locale. L'image de bac à sable par défaut est un Ubuntu minimal sans agent installé. Pour exécuter un véritable agent, suivez Exécutez votre premier agent : il exécute OpenCode contre un modèle OpenRouter gratuit et montre comment approuver un nouvel accès au fur et à mesure des besoins de l'agent.

Pour aller plus loin

• Bacs à sable : images, runtimes, GPU et cycle de vie.
• Politiques : règles de système de fichiers, de réseau et de processus, avec l'advisor et le prover pour examiner les changements.
• Fournisseurs : identifiants qui ne fonctionnent qu'aux points de terminaison approuvés, y compris l'inférence.
• Passerelles : le plan de contrôle pour les bacs à sable, la politique 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.
• Versions préliminaires 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 compétences apprennent à votre agent à piloter la CLI OpenShell, à écrire des politiques de bac à sable et à déboguer les passerelles et le routage d'inférence. Elles se trouvent dans skills/ et fonctionnent sans copie du code source d'OpenShell.

SDK

Les SDK connectent les applications à une passerelle OpenShell. Ils n'installent pas la CLI. Utilisez la même version d'OpenShell pour le SDK et la passerelle 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 bogues et demandes de fonctionnalités : GitHub Issues, en utilisant les modèles de ticket
• Vulnérabilités de sécurité : suivez SECURITY.md. N'ouvrez pas de ticket GitHub.
• Feuille de route : Feuille de route OpenShell et le tableau RFC
• Essayez-le dans le cloud : Brev Launchable

OpenShell est conçu agent-first : il est développé avec les mêmes flux de travail pilotés par agent qu'il permet. Voir CONTRIBUTING.md pour la configuration de développement et le flux de contribution, et AGENTS.md pour les conventions de codage du dépôt.

Télémétrie