بيئة تشغيل معزولة لوكلاء الذكاء الاصطناعي المستقلين مع سياسات YAML تعريفية تفرض قيودًا على نظام الملفات والشبكة والعمليات، بالإضافة إلى حقن بيانات الاعتماد المرتبطة بنقاط النهاية.
[!NOTE] 🚧 أصبح OpenShell الآن جزءًا من CNCF! نحن في عملية نقل التطوير إلى ai-openshell والحوكمة إلى CNCF. حتى يكتمل النقل، يُرجى الاستمرار في استخدام مستودع NVIDIA/OpenShell للكود والمشكلات وطلبات السحب.
[!IMPORTANT] جديد في OpenShell 0.1.x: إيقاع إصدارات مستقر، وبدائيات عزل جديدة، وسطح امتدادات موسّع، وواجهات برمجة تطبيقات جديدة. اقرأ دليل الترقية إلى 0.1.0.
OpenShell هو بيئة التشغيل الآمنة والخاصة لأساطيل وكلاء الذكاء الاصطناعي المستقلين. يكون الوكلاء أكثر فائدة عندما يستطيعون قراءة الملفات وتثبيت الحزم واستدعاء واجهات برمجة التطبيقات واستخدام بيانات الاعتماد. يمنحهم OpenShell هذه القدرة دون منحهم وصولًا غير مقيّد إلى بياناتك أو أسرارك أو شبكتك. تُصرّح بما يمكن لكل وكيل الوصول إليه في سياسة، ويقوم OpenShell بفرضها.
يحكم OpenShell ما يمكن للوكلاء فعله بطريقتين: فهو يزوّد النواة بأدوات المراقبة لفرض السياسة على كل وصول إلى الملفات وكل استدعاء نظام وكل اتصال شبكي في وقت التشغيل، ويستخدم التحقق الرسمي لفحص ما قد يسمح به تغيير السياسة قبل تطبيقه.
راجع البنية لمعرفة كيفية ترابط البوابة والمشرف وصندوق الرمل.
تحتاج إلى Linux، أو macOS على Apple Silicon، أو Windows مع WSL 2 (تجريبي)، بالإضافة إلى 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: فهو يشغّل OpenCode مقابل نموذج مجاني من OpenRouter ويوضح كيفية الموافقة على وصول جديد حسب حاجة الوكيل إليه.
لدعم Windows الأصلي عبر Microsoft MXC، راجع دليل البناء والتشغيل على Windows للاطلاع على الإعداد والقيود الحالية.
NetworkPolicy.main.ثبّت مهارات OpenShell العامة لوكيل البرمجة الخاص بك:
npx skills add NVIDIA/OpenShell
تعلّم المهارات وكيلك قيادة OpenShell CLI، وكتابة سياسات بيئات العزل (sandbox)، وتصحيح أخطاء البوابات وتوجيه الاستدلال. وهي موجودة في skills/ وتعمل دون الحاجة إلى نسخة مصدرية من OpenShell.
تربط حزم SDK التطبيقات ببوابة OpenShell. وهي لا تثبّت CLI. استخدم الإصدار نفسه من OpenShell لحزمة SDK وللبوابة متى أمكن.
| اللغة | التثبيت | الوثائق |
|---|---|---|
| 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 لاصطلاحات البرمجة في المستودع.