Skip to main content

[![PyPI](https://img.shields.io/pypi/v/pypot.svg)](https://pypi.python.org/pypi/pypot/) [![Build Status](https://travis-ci.org/poppy-project/pypot.svg?branch=master)](https://travis-ci.org/poppy-project/pypot) [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.13941.svg)](https://doi.org/10.5281/zenodo.13941)

# Pypot: A Python lib for Dynamixel motors control

Pypot is a library developed in the [inria FLOWERS](https://flowers.inria.fr/) team to make it easy and fast to control custom robots based on dynamixel motors. This framework provides different levels of abstraction corresponding to different types of use. More precisely, you can use pypot to:

  • directly control robotis motors (both protocol v1 and v2 are supported) through a USB2serial device,

  • define the structure of your particular robot and control it through high-level commands,

  • define primitives and easily combine them to create complex behavior.

Pypot has been entirely written in Python to allow for fast development, easy deployment and quick scripting by non-necessary expert developers. It can also benefits from the scientific and machine learning libraries existing in Python. The serial communication is handled through the standard library and thus allows for rather high performance (10ms sensorimotor loop). It is crossed-platform and has been tested on Linux, Windows and Mac OS.

Pypot is also compatible with the [V-REP simulator](http://www.coppeliarobotics.com). This allows you to seamlessly switch from a real robot to its simulated equivalent without having to modify your code.

Finally, it has been developed to permit an easy and fast extension to other types of motors and sensors.

## The Poppy-project: open source

Pypot is part of the [Poppy project](http://www.poppy-project.org) aiming at developing robotic creations that are easy to build, customize, deploy, and share. It promotes open-source by sharing hardware, software, and web tools.

At the moment we already proposed a few Poppy Creatures:

![Poppy Humanoid](./doc/poppy-creatures.jpg)

All those creatures are based on a combination of standard dynamixel actuators, 3D printed parts and open-source electronics such as Arduino boards. Both the hardware (3D models, electronics…) and software can be freely used, modified and duplicated.

## Documentation

The full pypot documentation on a html format can be found [here](http://poppy-project.github.io/pypot/). It provides tutorials, examples and a complete API.

The documentation is slowly moving toward [Jupyter Notebooks](http://jupyter.org) are they are such a powerful tool for writing and sharing tutorials, experiments or pedagogical contents.

They can be found [here](https://github.com/poppy-project/pypot/tree/master/samples/notebooks#notebooks-everywhere) with a detailed explanation on how they can be used, installed, and modified.

## Installation

Pypot is a library entirely written in [Python](https://www.python.org). It works with Python 2.7, 3.3+ and pypy-2.5. It is crossed platform and has been tested on Windows, Mac, Linux - yet specific usb to serial driver may be required depending on your system (see below).

Pypot also requires the following python package: * [pyserial](http://pyserial.sourceforge.net) 2.6 (or later) * [numpy](http://www.numpy.org) * [scipy](http://www.scipy.org/)

You can build and install pypot with the typically python way:

cd pypot python setup.py install

or directly via [pip](https://pip.pypa.io/en/latest/index.html):

pip install pypot

You will also have to install the driver for the USB2serial port. There are a few devices that have been tested with pypot that could be used:

  • USB2AX - this device is designed to manage TTL communication only

  • USB2Dynamixel - this device can manage both TTL and RS485 communication.

  • [Pixl board](https://github.com/poppy-project/pixl) for RaspberryPi

For more details on the installation procedure, please refer to the [installation section](http://poppy-project.github.io/pypot/intro.html#installation) of the documentation.

## Roadmap

The roadmap of the project can be found [here](https://github.com/poppy-project/pypot/blob/master/roadmap.md).

Metadata

Release files for pypoticia 3.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pypoticia 3.2.0
File Size Uploaded Provenance Actions
pypoticia-3.2.0.tar.gz 422.1 kB Without provenance Details for pypoticia-3.2.0.tar.gz

Release files / pypoticia-3.2.0.tar.gz

Download URL pypoticia-3.2.0.tar.gz
Size 422.1 kB
Tags Source
SHA-256 checksum
How to use checksums
9c2a694a677e0cc2f82e7a8844f5737250eea0f5b6317a784222678e467f74b0
BLAKE2b-256 checksum
How to use checksums
9aaa6ae770f922724a990c235ff1ec7b3b98c1a72308279cc2e19a1f779b6169
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for pypoticia 3.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page