Gym هي مكتبة Python مفتوحة المصدر لتطوير ومقارنة خوارزميات التعلم التعزيز من خلال توفير واجهة برمجة تطبيقات قياسية للتواصل بين خوارزميات التعلم والبيئات ، بالإضافة إلى مجموعة قياسية من البيئات المتوافقة مع API. منذ صدوره ، أصبحت واجهة برمجة تطبيقات Gym هي المعيار الميداني للقيام بذلك.
موقع توثيق الصالة الرياضية موجود في https://www.gymlibrary.dev/ ، ويمكنك اقتراح إصلاحات وتغييرات هنا.
لدى Gym أيضًا خادم Discord لأغراض التطوير التي يمكنك الانضمام إليها هنا: https://discord.gg/nhg2jrn489
لتثبيت مكتبة الصالة الرياضية الأساسية ، استخدم pip install gym
.
لا يشمل ذلك تبعيات لجميع عائلات البيئات (هناك عدد ضخم ، وقد يكون بعضها مشكلة في التثبيت على أنظمة معينة). يمكنك تثبيت هذه التبعيات لعائلة واحدة مثل pip install gym[atari]
أو استخدام pip install gym[all]
لتثبيت جميع التبعيات.
نحن ندعم Python 3.7 و 3.8 و 3.9 و 3.10 على Linux و MacOS. سوف نقبل PRS المتعلقة بـ Windows ، لكننا لا ندعمها رسميًا.
بيئات طرازات API في Gym API كطبقات بسيطة Python env
. إن إنشاء مثيلات بيئة والتفاعل معها بسيط للغاية- إليك مثال باستخدام بيئة "CartPole-V1":
import gym
env = gym . make ( "CartPole-v1" )
observation , info = env . reset ( seed = 42 )
for _ in range ( 1000 ):
action = env . action_space . sample ()
observation , reward , terminated , truncated , info = env . step ( action )
if terminated or truncated :
observation , info = env . reset ()
env . close ()
يرجى ملاحظة أن هذه قائمة غير مكتملة ، وتتضمن فقط المكتبات التي يشير إليها المشرفون الأكثر شيوعًا إلى NewCommers عند طلب التوصيات.
يحافظ الصالة الرياضية على إصدار صارم لأسباب استنساخ. جميع البيئات تنتهي في لاحقة مثل "_v0". عندما يتم إجراء تغييرات على البيئات التي قد تؤثر على نتائج التعلم ، يتم زيادة العدد من قبل واحد لمنع الارتباك المحتمل.
لن تعتمد أحدث إصدارات "_v4" والإصدارات المستقبلية لبيئات Mujoco على mujoco-py
. بدلاً من ذلك ، سيكون mujoco
التبعية المطلوبة لإصدارات بيئة Mujoco في المستقبل. ستظل إصدارات بيئة الصالة الرياضية القديمة التي تعتمد على mujoco-py
غير محفوظة. لتثبيت التبعيات لأحدث بيئات صالة الألعاب الرياضية ، استخدم pip install gym[mujoco]
. لا يزال من الممكن تثبيت تبعيات بيئات Mujoco القديمة بواسطة pip install gym[mujoco_py]
.
يتوفر ورقة بيضاء من عندما خرجت الصالة الرياضية للتو https://arxiv.org/pdf/1606.01540 ، ويمكن ذكرها مع إدخال bibtex التالي:
@misc{1606.01540,
Author = {Greg Brockman and Vicki Cheung and Ludwig Pettersson and Jonas Schneider and John Schulman and Jie Tang and Wojciech Zaremba},
Title = {OpenAI Gym},
Year = {2016},
Eprint = {arXiv:1606.01540},
}
اعتاد أن يتم إصدار ملاحظات لجميع إصدارات الصالة الرياضية الجديدة هنا. يتم نقل ملاحظات الإصدار الجديدة إلى صفحة الإصدارات على Github ، كما تفعل معظم المكتبات الأخرى. يمكن الاطلاع على الملاحظات القديمة هنا.