Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

Bullet-based simulation for SoftBank Robotics' robots

Project description

qibullet Build Status pypi Gitter chat

Bullet-based python simulation for SoftBank Robotics' robots.


The following modules are required:

  • numpy
  • pybullet

The qibullet module can be installed via pip, for python 2.7 and python 3:

pip install --user qibullet


Please note that only the Pepper robot is currently handled by this module. A robot can be spawn via the SimulationManager class:

from qibullet import SimulationManager

if __name__ == "__main__":
    simulation_manager = SimulationManager()

    # Launch a simulation instances, with using a graphical interface.
    # Please note that only one graphical interface can be launched at a time
    client_id = simulation_manager.launchSimulation(gui=True)

    # Spawning a virtual Pepper robot, at the origin of the WORLD frame, and a
    # ground plane
    pepper = simulation_manager.spawnPepper(
        translation=[0, 0, 0],
        quaternion=[0, 0, 0, 1],

Or using loadRobot from the PepperVirtual class if you already have a simulated environment:

    pepper = PepperVirtual()

      translation=[0, 0, 0],
      quaternion=[0, 0, 0, 1],

More snippets can be found in the examples folder, or in the repository wiki


The qibullet API documentation can be found here. The documentation can be generated via the following command (the doxygen package has to be installed beforehand, and the docs folder has to exist):

cd docs

The repository also contains a wiki, providing some tutorials.


Please cite qibullet if you use this repository in your publications:

Paper coming soon...


OpenGL driver

If you encounter the message:

Workaround for some crash in the Intel OpenGL driver on Linux/Ubuntu

Your computer is using the Intel OpenGL driver. Go to Software & Updates, Additional Drivers, and select a driver corresponding to your GPU.


Licensed under the Apache-2.0 License

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
qibullet-1.0.12-py2-none-any.whl (2.2 MB) Copy SHA256 hash SHA256 Wheel py2
qibullet-1.0.12.tar.gz (2.1 MB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page