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.
<!-- 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] > **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](https://docs.nvidia.com/openshell/latest/upgrade/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](https://docs.nvidia.com/openshell/latest/about/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](https://docs.nvidia.com/openshell/latest/about/support-matrix) pour plus de détails. ```shell 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](https://docs.nvidia.com/openshell/latest/about/run-your-first-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](https://docs.nvidia.com/openshell/latest/how-it-works/sandboxes/overview) : images, runtimes, GPU et cycle de vie. - [Politiques](https://docs.nvidia.com/openshell/latest/how-it-works/policies/overview) : règles de système de fichiers, de réseau et de processus, avec l'[advisor](https://docs.nvidia.com/openshell/latest/how-it-works/policies/advisor) et le [prover](https://docs.nvidia.com/openshell/latest/how-it-works/policies/prover) pour examiner les changements. - [Fournisseurs](https://docs.nvidia.com/openshell/latest/how-it-works/providers/overview) : identifiants qui ne fonctionnent qu'aux points de terminaison approuvés, y compris l'[inférence](https://docs.nvidia.com/openshell/latest/how-it-works/inference). - [Passerelles](https://docs.nvidia.com/openshell/latest/how-it-works/gateways/overview) : le plan de contrôle pour les bacs à sable, la politique et l'accès. - [Kubernetes](https://docs.nvidia.com/openshell/latest/kubernetes/setup) : déployez la passerelle avec Helm. Votre CNI doit appliquer `NetworkPolicy`. - [Extensibilité](https://docs.nvidia.com/openshell/latest/extensibility/overview) : middleware, intercepteurs et pilotes de calcul. - [Tutoriels](https://docs.nvidia.com/openshell/latest/tutorials/first-network-policy) : parcours pas à pas sur les politiques et les agents. - [Versions préliminaires et de développement](https://docs.nvidia.com/openshell/latest/about/installation#prerelease-and-development-builds) : 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 : ```shell 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/`](https://github.com/nvidia/openshell/blob/main/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](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>` | [Installation et utilisation](https://github.com/nvidia/openshell/blob/main/docs/sdk/rust.mdx) | ## Communauté - **Questions et discussions :** [GitHub Discussions](https://github.com/NVIDIA/OpenShell/discussions) - **Rapports de bogues et demandes de fonctionnalités :** [GitHub Issues](https://github.com/NVIDIA/OpenShell/issues), en utilisant les modèles de ticket - **Vulnérabilités de sécurité :** suivez [SECURITY.md](https://github.com/nvidia/openshell/blob/main/SECURITY.md). N'ouvrez pas de ticket GitHub. - **Feuille de route :** [Feuille de route OpenShell](https://github.com/orgs/NVIDIA/projects/233) et le [tableau RFC](https://github.com/orgs/NVIDIA/projects/233/views/6) - **Essayez-le dans le cloud :** [Brev Launchable](https://brev.nvidia.com/launchable/deploy/now?launchableID=env-3Ap3tL55zq4a8kew1AuW0FpSLsg) 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](https://github.com/nvidia/openshell/blob/main/CONTRIBUTING.md) pour la configuration de développement et le flux de contribution, et [AGENTS.md](https://github.com/nvidia/openshell/blob/main/AGENTS.md) pour les conventions de codage du dépôt. ## Télémétrie OpenShell collecte des données de télémétrie anonymes, limitées à des catégories et des comptages opérationnels, pour aider à améliorer le projet. Il ne collecte pas les noms de bacs à sable, les noms d'hôtes, les chemins de fichiers, les invites, les identifiants, les noms de fournisseurs ou de modèles, ni le contenu utilisateur. Pour la désactiver, définissez `OPENSHELL_TELEMETRY_ENABLED=false` sur la passerelle, ou `server.telemetryEnabled=false` pour les installations Helm. Vous pouvez également exclure entièrement la télémétrie à la compilation. Voir [Télémétrie](https://docs.nvidia.com/openshell/latest/observability/telemetry) pour plus de détails et les [rapports de télémétrie communautaires](https://github.com/nvidia/openshell/blob/main/telemetry/README.md) pour les tendances d'utilisation publiées. ## Avis et clause de non-responsabilité Ce logiciel récupère, accède ou interagit automatiquement avec des matériaux externes. Ces matériaux récupérés ne sont pas distribués avec ce logiciel et sont régis uniquement par des termes, conditions et licences distincts. Vous êtes seul responsable de la recherche, de l'examen et du respect de tous les termes, conditions et licences applicables, ainsi que de la vérification de la sécurité, de l'intégrité et de l'adéquation de tout matériau récupéré pour votre cas d'usage spécifique. Ce logiciel est fourni « EN L'ÉTAT », sans garantie d'aucune sorte. L'auteur ne fait aucune déclaration ni garantie concernant les matériaux récupérés, et n'assume aucune responsabilité pour toute perte, dommage, responsabilité ou conséquence juridique résultant de votre utilisation ou de votre impossibilité d'utiliser ce logiciel ou tout matériau récupéré. Utilisez ce logiciel et les matériaux récupérés à vos propres risques. ## Licence Ce projet est sous licence [Apache License 2.0](https://github.com/NVIDIA/OpenShell/blob/main/LICENSE).
