Repolode
提交项目
learnsyslab

learnsyslab/gym-pybullet-drones

基于 PyBullet 的 Gymnasium 环境，用于训练单机与多机四旋翼无人机的强化学习控制策略。

在 GitHub 查看官网
Star
2,201
Fork
578
未关闭 Issue
111
最近提交
昨天

这是什么？

gym-pybullet-drones 是一个基于 PyBullet 物理引擎和 Gymnasium 接口的四旋翼仿真环境，用于训练单机及多机协同控制的强化学习策略。常见任务包括悬停、编队飞行，以及无人机之间的下洗气流（downwash）影响。

项目是早期 IROS 2021 代码库的精简重构，兼容 Gymnasium 和 Stable-Baselines3 2.0。内置 PID、速度控制和 MRAC 自适应控制示例，并提供基于 PPO 的训练与回放脚本。

此外，项目在 Ubuntu 上提供 Betaflight SITL 示例，可让多个仿真飞控与该环境联动运行。

核心功能

  • 01兼容 Gymnasium 的单机与多机四旋翼环境
  • 02基于 PyBullet 物理仿真
  • 03提供 PID、速度控制与 MRAC 控制器示例
  • 04集成 Stable-Baselines3 的 PPO 训练与回放脚本
  • 05支持无人机间下洗气流效应建模
  • 06在 Ubuntu 上支持 Betaflight SITL 联动

适用场景

  • 训练四旋翼悬停或轨迹跟踪的强化学习控制器
  • 研究多机协同与编队飞行
  • 在软件在环环境中用 Betaflight 固件测试控制算法

快速上手

  1. 1

    克隆仓库

    git clone https://github.com/learnsyslab/gym-pybullet-drones.git
  2. 2

    创建并激活 Python 3.12 的 conda 环境

    conda create -n drones python=3.12 && conda activate drones
  3. 3

    以可编辑模式安装该包

    pip3 install -e .
  4. 4

    运行 PID 控制示例

    cd gym_pybullet_drones/examples/ && python3 pid.py

使用前须知

  • 在 Python 3.10 以上版本中，pybullet 没有预编译包，可能需要编译器或 macOS 专用的 CFLAGS 设置。
  • Betaflight SITL 示例仅支持 Ubuntu。

收录于专题

开源 AI Agent 框架与应用强化学习训练框架与环境机器人与具身智能项目

标签

#reinforcement-learning#quadcopter#drone#robotics#pybullet#gymnasium#multi-agent#simulation#betaflight#control

常见问题

gym-pybullet-drones 是什么？
基于 PyBullet 的 Gymnasium 环境，用于训练单机与多机四旋翼无人机的强化学习控制策略。 gym-pybullet-drones 是一个基于 PyBullet 物理引擎和 Gymnasium 接口的四旋翼仿真环境，用于训练单机及多机协同控制的强化学习策略。常见任务包括悬停、编队飞行，以及无人机之间的下洗气流（downwash）影响。
gym-pybullet-drones 可以免费使用吗？用的什么许可证？
gym-pybullet-drones 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
gym-pybullet-drones 还在维护吗？
活跃维护中。gym-pybullet-drones 最近一次提交是在 2026年11月6日。
gym-pybullet-drones 适合用来做什么？
训练四旋翼悬停或轨迹跟踪的强化学习控制器 研究多机协同与编队飞行 在软件在环环境中用 Betaflight 固件测试控制算法
gym-pybullet-drones 怎么安装和运行？
克隆仓库: git clone https://github.com/learnsyslab/gym-pybullet-drones.git 创建并激活 Python 3.12 的 conda 环境: conda create -n drones python=3.12 && conda activate drones 以可编辑模式安装该包: pip3 install -e . 运行 PID 控制示例: cd gym_pybullet_drones/examples/ && python3 pid.py
在哪里获取 gym-pybullet-drones？
源代码和安装说明在 GitHub 上：https://github.com/learnsyslab/gym-pybullet-drones

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目