쿼드콥터용 단일·멀티 에이전트 강화학습 컨트롤러를 훈련하는 PyBullet 기반 Gymnasium 환경입니다.
Farama-Foundation/Gymnasium-Robotics
Gymnasium API를 기반으로 구축된 MuJoCo 로봇 강화 학습 환경 모음입니다.
- 스타
- 1,966
- 포크
- 161
- 열린 이슈
- 28
- 마지막 커밋
- 24일 전
어떤 프로젝트인가요?
Gymnasium-Robotics는 강화 학습을 위한 시뮬레이션 로봇 환경을 제공하며, Gymnasium API로 사용할 수 있고 MuJoCo 물리 엔진에서 실행됩니다. 7-DoF Fetch 로봇 팔을 이용한 조작 작업, 24-DoF Shadow Dexterous Hand를 이용한 손 안에서의 정교한 조작, PettingZoo ParallelEnv API를 따르는 Gymnasium MuJoCo 환경의 멀티 에이전트 팩터라이제이션을 지원합니다.
또한 미로 탐색, Adroit 손 조작 작업, Franka Kitchen 멀티태스크 설정 등 리팩터링된 D4RL 환경도 포함합니다. 로봇 환경은 GoalEnv 클래스를 기반으로 한 멀티 골 API를 사용하며, 관측값에는 observation, desired_goal, achieved_goal 키가 포함됩니다. Hindsight Experience Replay를 위해 대체 목표를 지정해 보상 함수와 종료 함수를 다시 계산할 수 있습니다.
pip으로 설치할 수 있습니다. Linux와 macOS를 공식 지원합니다. 최신 환경은 현재 mujoco Python 바인딩을 사용하며, 레거시 버전은 mujoco-py에 의존합니다.
핵심 기능
- 01reach, push, slide, pick-and-place 작업을 위한 7-DoF 팔 기반 Fetch 환경.
- 02객체 조작을 위한 Shadow Dexterous Hand 환경이며, 터치 센서 관측값을 선택적으로 사용할 수 있습니다.
- 03PettingZoo ParallelEnv API를 사용하는 멀티 에이전트 MuJoCo 환경.
- 04리팩터링된 D4RL 미로, Adroit, Franka Kitchen 환경.
- 05Hindsight Experience Replay를 위한 목표 리라벨링을 지원하는 멀티 골 GoalEnv 인터페이스.
활용 사례
- 로봇 조작 작업에서 강화 학습 알고리즘을 벤치마크합니다.
- 목표 조건부 정책을 학습하고 hindsight 리라벨링을 적용합니다.
- 팩터라이즈된 MuJoCo 로봇을 활용한 멀티 에이전트 제어를 연구합니다.
- D4RL 스타일의 미로 및 주방 작업에서 오프라인 RL 실험을 수행합니다.
빠른 시작
- 1
PyPI에서 라이브러리를 설치합니다
pip install gymnasium-robotics - 2
MuJoCo 웹사이트의 안내에 따라 물리 엔진 MuJoCo를 설치합니다
- 3
라이브러리를 가져와 환경을 등록한 다음 FetchReach-v4와 같은 환경을 생성합니다
사용 전 알아둘 점
- 공식적으로 지원하는 운영체제는 Linux와 macOS뿐이며, Windows는 공식 지원하지 않습니다.
- 물리 엔진 MuJoCo를 별도로 설치해야 합니다.
- 이전 환경은 mujoco-py에 의존하며, 선택적 추가 설치가 필요합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- Gymnasium-Robotics은(는) 무엇인가요?
- Gymnasium API를 기반으로 구축된 MuJoCo 로봇 강화 학습 환경 모음입니다. Gymnasium-Robotics는 강화 학습을 위한 시뮬레이션 로봇 환경을 제공하며, Gymnasium API로 사용할 수 있고 MuJoCo 물리 엔진에서 실행됩니다. 7-DoF Fetch 로봇 팔을 이용한 조작 작업, 24-DoF Shadow Dexterous Hand를 이용한 손 안에서의 정교한 조작, PettingZoo ParallelEnv API를 따르는 Gymnasium MuJoCo 환경의 멀티 에이전트 팩터라이제이션을 지원합니다.
- Gymnasium-Robotics은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- Gymnasium-Robotics은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- Gymnasium-Robotics은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. Gymnasium-Robotics의 마지막 커밋은 2026년 10월 14일입니다.
- Gymnasium-Robotics은(는) 어디에 사용할 수 있나요?
- 로봇 조작 작업에서 강화 학습 알고리즘을 벤치마크합니다. 목표 조건부 정책을 학습하고 hindsight 리라벨링을 적용합니다. 팩터라이즈된 MuJoCo 로봇을 활용한 멀티 에이전트 제어를 연구합니다. D4RL 스타일의 미로 및 주방 작업에서 오프라인 RL 실험을 수행합니다.
- Gymnasium-Robotics는 어떻게 설치하나요?
- PyPI에서 라이브러리를 설치합니다: pip install gymnasium-robotics MuJoCo 웹사이트의 안내에 따라 물리 엔진 MuJoCo를 설치합니다 라이브러리를 가져와 환경을 등록한 다음 FetchReach-v4와 같은 환경을 생성합니다
- Gymnasium-Robotics은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Farama-Foundation/Gymnasium-Robotics
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
센서 시뮬레이션과 Gymnasium 스타일 환경을 제공하는 강화 학습 및 자율주행 연구용 경량 Python 주행 시뮬레이터입니다.
ASPIRE는 모델 가중치를 학습하는 대신 코딩 에이전트가 재사용 가능한 로봇 스킬을 반복적으로 개선하는 프레임워크입니다.
에디터와 런타임에서 MuJoCo 물리를 실행하고, 정확한 접촉 동역학과 Unreal 렌더링을 결합하는 Unreal Engine 5 플러그인입니다.
Gymnasium과 유사한 표준 API와 참조 환경을 제공하는 멀티 에이전트 강화학습 연구용 Python 라이브러리입니다.
자율주행 및 의사결정 에이전트의 학습과 테스트를 위한 Gymnasium 호환 시뮬레이션 주행 환경 모음입니다.