Read the current positions of the robot's joints in radians and motor units.

Read Joint Positions

Location

Message

Error Type

ValidationError

Response to read the joints of the robot.

JointsReadResponse

HTTPValidationError

phospho

An absurdly simple way to train AI models for real-world robots, built for ML engineers.

Introduction

How to set up phosphobot for free and control your robot arm in simulation and in real life.

Installation

How to set up phosphobot and control your robot arm

Quickstart

Dev kit unboxing

How to remote control a robot arm with a keyboard, in VR, with an API or a leader arm?

Control your robot arm

How to record a robotics dataset with your robot?

Record a robotics dataset

How to train a robotics AI model with a dataset?

Train a robotics AI model

How to make an AI model control your robot?

Control robot with AI models

Core Robotics Concepts

How to move a robot arm to a specific position.

Kinematics

A guide to training AI models that control robots

Train robotics AI models

 Policies

Understanding Gravity Compensation in Robotics

Gravity Compensation

What kind of cameras are used in robotics ?

Cameras

How to build the SO-100 robot arm? Step by step guide

Build the SO-100 robot arm

How to control the robot arm with API calls.

Simple controls

How to leverage vision models for robotics.

Computer vision

How to control your robot arm using a Meta Quest 3 over a local WiFi network

Teleoperation on local network

Control your robot over the internet using ngrok

Teleoperation from anywhere in the world

Github

(External) phospho platform

Get hardware

Contact us

Initialize the robot to its initial position before starting the teleoperation.

Initialize Robot

Teleoperation Control

High frequency control of the robot arm via WebSocket connection for real-time updates and commands.

Teleoperation Control (WebSocket)

Move the robot to an absolute position specified by the end-effector (in centimeters and degrees). Make sure to call `/move/init` before using this endpoint.

Move to Absolute Position

Move the robot to a relative position based on received delta values (in centimeters and degrees).

Move to Relative Position

Retrieve the position, orientation, and open status of the robot's end effector.

Read End-Effector Position

Read the current torque of the robot's joints.

Read Torque

Enable or disable the torque of the robot.

Toggle Torque

Move the robot's joints to the specified angles.

Write Joint Positions

Start the calibration sequence for the robot.

Calibrate Robot

Stream video feed of the specified camera. If no camera id is provided, the default camera is used. If the camera id is 'realsense' or 'depth', the realsense camera is used.Specify a target size and quality using query parameters.

Video Feed For Camera

Asynchronously start recording an episode in the background.
Output format is chosen when stopping the recording.

Start Recording Episode

Stop the recording of the episode. The data is saved to disk to the user home directory, in the `phosphobot` folder.

Getting Started

Basic Usage

Learn

Examples

API Reference

Read Joint Positions

Query Parameters

Response