Skip to main content

command-line interface and Python package for the Brunel Hand by Open Bionics

Project description


This repository provides a command-line interface and Python package for the Brunel Hand by Open Bionics.

The main design goal is to provide a fast and reliable interface to the firmware, Beetroot. Motivating use-cases are rapid prototyping and integration into more complicated applications.


To install the current release, try:

pip install bhand

which uses pip to install dependencies and this Python package. Now, connect the USB cable from your Brunel Hand into your host machine, and try:


It should print diagnostics data, e.g., the CPU temperature. Note that serial communications use pySerial. To obtain a help message, try:

bhand --raw ?

The ? command is recognized by the firmware Beetroot V1.01. (In some shells, ? is a special character and has to be escaped. If the above fails, try instead bhand --raw \?.)

Current testing status for master branch: build-status (for details, visit the page on Travis CI).

Bug reports and feature requests can be submitted in the issue tracker at


All participation must follow our code of conduct, elaborated in the file in the same directory as this README.

Reporting errors, requesting features

Please first check for prior reports that are similar or related in the issue tracker at If your observations are indeed new, please open a new issue

Security disclosures are given the highest priority and should be sent to Scott <>, optionally encrypted using his public key. Please do so before opening a public issue to allow us an opportunity to find a fix.

Contributing changes or new code

Contributions are welcome! There is no formal declaration of code style. Just try to follow the style and structure currently in the repository.

Contributors, who are not rerobots employees, must agree to the Developer Certificate of Origin. Your agreement is indicated explicitly in commits by adding a Signed-off-by line with your real name. (This can be done automatically using git commit --signoff.)


This is free software, released under the Apache License, Version 2.0. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project details

Download files

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

Source Distribution

bhand-0.1.0.tar.gz (6.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page