Reachy's cameras

This section assumes that you went through the Hello World so that you know how to connect to the robot.

Reachy 2021 has two high quality cameras which can deliver up to 1080p at 30 fps. Each camera is equipped with a motorized zoom allowing to adapt the zoom level to the situation you’re working on.

Each camera can be accessed separately with reachy.left_camera and reachy.right_camera.

First, connect to your Reachy.

from reachy_sdk import ReachySDK

reachy = ReachySDK(host='')  # Replace with the actual IP

>>> <Camera side="left" resolution=(720, 1280, 3)>

The left and right sides are considered from Reachy point of view.


Get the images

The last image captured by each camera can be obtained with the .last_frame attribute.

import cv2 as cv

img = reachy.right_camera.last_frame

cv.imshow('right_frame', img)

Control the motorized zoom

The piloting of Reachy’s zooms is working with, zoom_kurokesu, a custom python library.

Zoom level

There are three zoom levels available: ‘in’, ‘out’, ‘inter’.

  • ‘in’: for close objects,
  • ‘out’: for further objects,
  • ‘inter’: in between the ‘in’ and ‘out’ positions.

The zoom levels have been selected so that if you set the same zoom level on both cameras, you should see the same image (slightly shifted of course considering the cameras are few centimeters from each other).

The current zoom level applied to a camera can be checked.

>>> <ZoomLevel.INTER: 2>

>>> <ZoomLevel.INTER: 2>

The zoom level can be set with ZoomLevel from

from import ZoomLevel

reachy.left_camera.zoom_level = ZoomLevel.OUT
reachy.right_camera.zoom_level = ZoomLevel.IN

You should hear the Reachy’s zooms motors moving.

Getting the last frame from each camera, you should see the different zoom levels have been applied.

If when using the zooms you get images blurrier than what they are supposed to be, use the homing command. Each zoom level sends positions instructions relatively to a base position and it may happen that the base positions get a bit drifted. The homing instruction bring the zoom motors to their limit and reset the base positions from it.


Once the homing executed, you can reset a zoom position.

reachy.left_camera.zoom_level = ZoomLevel.INTER

Zoom speed

The speed of the zoom motors can also be changed along with the level.

The value of the speed is an int between 4000 and 40000, by default the value is at 10000 but you can change it easily.

>>> 10000

reachy.left_camera.zoom_speed = 30000

>>> 30000

Edit this page on GitHub