JeanElsner / panda-py

Python bindings for real-time control of Franka Emika robots.
https://jeanelsner.github.io/panda-py/
Apache License 2.0
97 stars 17 forks source link
control emika franka panda python real-time robot
panda-py Logo

panda-py

Continuous Integration Apache-2.0 License PyPI - Published Version PyPI - Python Version Documentation

Finally, Python bindings for the Panda. These will increase your productivity by 1000%, guaranteed[^1]!

Getting started

To get started, check out the tutorial paper, Jupyter notebooks and other examples you can run directly on your robot. For more details on the API, please refer to the documentation.

Extensions

Install

pip install panda-python

This will install panda-py and all its requirements. The pip version ships with libfranka 0.9.2, the newest version for the Franka Emika Robot. Please refer to the section below if you use an older system version or the more recent Franka Research 3 robot.

libfranka Version

There are currently two robot models available from Franka Emika: the Franka Emika Robot (FER, formerly known as Panda) and the Franka Research 3 (FR3). Depending on the installed firmware, the FER supports version <0.10 while the FR3 requires version >=0.10. For details, refer to this compatibility matrix. If you need a libfranka version different from the default 0.9.2, download the respective zip archive from the release page. Extract the archive and install the wheel for your Python version with pip, e.g., run

pip install panda_python-*libfranka.0.7.1-cp310*.whl

to install the binary wheel for libfranka 0.7.1 and Python 3.10.

Citation

If you use panda-py in published research, please consider citing the original software paper.

@article{elsner2023taming,
title = {Taming the Panda with Python: A powerful duo for seamless robotics programming and integration},
journal = {SoftwareX},
volume = {24},
pages = {101532},
year = {2023},
issn = {2352-7110},
doi = {https://doi.org/10.1016/j.softx.2023.101532},
url = {https://www.sciencedirect.com/science/article/pii/S2352711023002285},
author = {Jean Elsner}
}

[^1]: Not actually guaranteed. Based on a sample size of one.