OpenShell v0.1.6
بيئة تشغيل معزولة لوكلاء الذكاء الاصطناعي المستقلين مع سياسات YAML تعريفية تفرض قيودًا على نظام الملفات والشبكة والعمليات، بالإضافة إلى حقن بيانات الاعتماد المرتبطة بنقاط النهاية.
[!IMPORTANT] جديد في OpenShell 0.1.x: إيقاع إصدارات مستقر، وبدائيات عزل جديدة، وسطح امتدادات موسّع، وواجهات برمجية جديدة. اقرأ دليل الترقية إلى 0.1.0.
OpenShell هو بيئة التشغيل الآمنة والخاصة لأساطيل وكلاء الذكاء الاصطناعي المستقلين. يكون الوكلاء أكثر فائدة عندما يستطيعون قراءة الملفات وتثبيت الحزم واستدعاء واجهات API واستخدام بيانات الاعتماد. يمنحهم OpenShell هذه القدرة دون منحهم وصولاً غير مقيّد إلى بياناتك أو أسرارك أو شبكتك. تُصرّح بما يمكن لكل وكيل الوصول إليه في سياسة، ويقوم OpenShell بفرضها.
كيف يعمل
يحكم OpenShell ما يمكن للوكلاء فعله بطريقتين: فهو يزوّد النواة (kernel) بأدوات لفرض السياسة على كل وصول إلى الملفات وكل استدعاء نظام وكل اتصال شبكي أثناء التشغيل، ويستخدم التحقق الشكلي (formal verification) لفحص ما قد يسمح به تغيير السياسة قبل تطبيقه.
- الفرض على مستوى النواة. يعمل كل وكيل في صندوق رمل معزول. تقيّد عناصر التحكم في النواة الملفات التي يمكنه الوصول إليها واستدعاءات النظام التي يمكنه إجراؤها، ويمر كل اتصال شبكي عبر فحص للسياسة قبل مغادرته صندوق الرمل. لا يرى الوكلاء أبدًا بيانات اعتماد حقيقية؛ إذ يضيفها OpenShell فقط إلى الطلبات المتجهة إلى نقاط نهاية معتمدة.
- تغييرات سياسة مُتحقَّق منها شكليًا. قبل الموافقة على تغيير في السياسة، يستخدم OpenShell التحقق الشكلي لتمييز الوصول الجديد المحفوف بالمخاطر الذي قد يمنحه، مثل الوصول إلى مضيف جديد باستخدام بيانات اعتماد أو استدعاء طريقة API جديدة، بحيث تنتظر تلك التغييرات مراجعة بشرية.
راجع البنية لمعرفة كيفية ترابط البوابة (gateway) والمشرف (supervisor) وصندوق الرمل (sandbox).
البدء السريع
تحتاج إلى 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 للاطلاع على الإعداد والقيود الحالية.
استكشف المزيد
- Sandboxes: الصور وأوقات التشغيل ووحدات GPU ودورة الحياة.
- Policies: قواعد نظام الملفات والشبكة والعمليات، مع المستشار والمُثبِت لمراجعة التغييرات.
- Providers: بيانات اعتماد تعمل فقط عند نقاط النهاية المعتمدة، بما في ذلك الاستدلال.
- Gateways: مستوى التحكم في الصناديق الرملية والسياسات والوصول.
- Kubernetes: انشر البوابة باستخدام Helm. يجب أن يفرض CNI الخاص بك
NetworkPolicy. - Extensibility: البرمجيات الوسيطة والمعترضات ومشغلات الحوسبة.
- Tutorials: جولات إرشادية خطوة بخطوة للسياسات والوكلاء.
- Prerelease and development builds: جرّب إصدارًا قادمًا أو أحدث commit على
main.
مهارات الوكيل
ثبّت مهارات OpenShell العامة لوكيل البرمجة الخاص بك:
npx skills add NVIDIA/OpenShell
تعلّم المهارات وكيلك كيفية تشغيل OpenShell CLI، وكتابة سياسات بيئات العزل (sandbox policies)، وتصحيح أخطاء البوابات وتوجيه الاستدلال. وهي موجودة في skills/ وتعمل دون الحاجة إلى نسخة مصدرية من OpenShell.
حزم SDK
تربط حزم SDK التطبيقات ببوابة OpenShell. وهي لا تثبّت CLI. استخدم الإصدار نفسه من OpenShell لكل من SDK والبوابة متى أمكن.
| اللغة | التثبيت | الوثائق |
|---|---|---|
| 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 and usage |
المجتمع
- الأسئلة والنقاش: GitHub Discussions
- تقارير الأخطاء وطلبات الميزات: GitHub Issues، باستخدام قوالب المشكلات
- الثغرات الأمنية: اتبع SECURITY.md. لا تفتح مشكلة على GitHub.
- خارطة الطريق: OpenShell Roadmap ولوحة RFC
- جرّبه في السحابة: Brev Launchable
صُمّم OpenShell ليكون الوكيل أولاً: فهو يُطوَّر باستخدام سير العمل نفسه القائم على الوكلاء الذي يمكّنه. راجع CONTRIBUTING.md لإعداد التطوير وسير عمل المساهمة، وAGENTS.md لاصطلاحات البرمجة في المستودع.
القياس عن بُعد (Telemetry)
يجمع OpenShell قياسات عن بُعد مجهولة الهوية، تقتصر على الفئات التشغيلية والأعداد، للمساعدة في تحسين المشروع. وهو لا يجمع أسماء بيئات العزل، أو أسماء المضيفين، أو مسارات الملفات، أو المطالبات (prompts)، أو بيانات الاعتماد، أو أسماء المزوّدين أو النماذج، أو محتوى المستخدم. لتعطيله، اضبط OPENSHELL_TELEMETRY_ENABLED=false على البوابة، أو server.telemetryEnabled=false لعمليات التثبيت عبر Helm. يمكنك أيضًا استبعاد القياس عن بُعد بالكامل عند الترجمة (compile). راجع Telemetry للتفاصيل وتقارير القياس عن بُعد المجتمعية لاتجاهات الاستخدام المنشورة.