Installation

​

Install phosphobot

The quickest way to get started is to use the install script. In a terminal, run the following command:

curl -fsSL https://raw.githubusercontent.com/phospho-app/phosphobot/main/install.sh | bash

Then, run the phosphobot server:

phosphobot run

It can take up to 15 seconds for the server to start for the first time because of macOS security settings.

On the same computer, open a web browser and navigate to localhost. You should now see the phosphobot dashboard.

• If you bought the phospho dev kit, send API requests or use Keyboard Control to test the connection with the robot.
• If you built your own robot arm, you should first calibrate it.
• Everything works? Great! You’re ready to send your first commands.

​

MacOS

Use Homebrew to install phosphobot:

brew tap phospho-app/phosphobot
brew install phosphobot

To update phosphobot, run the following command:

brew update && brew upgrade phosphobot

​

Linux (APT)

On Linux, we use apt to distribute the software and you need additional packages. That’s why you need to run the install script with sudo:

curl -fsSL https://raw.githubusercontent.com/phospho-app/phosphobot/main/install.sh | sudo bash

To update phosphobot, run the following command:

sudo apt update && sudo apt install --only-upgrade phosphobot

​

Raspberry Pi

phosphobot on Raspberry Pi has advanced features to make it easier to use (led ticking, bluetooth connection, extra dependencies already installed).

1. SSH into the Raspberry Pi

SSH (Secure Shell) allows you to access the Raspberry Pi remotely from your main computer through the terminal.

Turn on the Raspberry Pi by plugging it to a power source. Wait for it to boot (look for the LED pattern)

Then, open a terminal and SSH into your Raspberry Pi. If you’ve followed the previous part, this means running on your computer this command :

ssh phosphobot@phosphobot.local

If you didn’t follow the previous part, the username@hostname.local and password may be different.

When asked about the authenticity of host phosphobot.local, type yes to accept.

And when asked for password, enter password123 .

2. Install the software

When you’ve successfully SSH in the Raspberry Pi, run this to install the teleoperation server :

curl -fsSL https://raw.githubusercontent.com/phospho-app/phosphobot/main/install.sh | sudo bash

Your Raspberry Pi should be connected to the internet.

• When prompted btberrywifi install location, leave blank.
• When prompted bluetooth password, leave blank
• When prompted Enter your country code, specify your country code (eg: US, FR…)

After that, the installation script will download install dependencies. It can take a few minutes depending on your connection speed.

3. Once the installation is complete, reboot your Raspberry Pi.

sudo reboot

​

Windows

We don’t offer prebuilt binaries for Windows, but we’ve successfully used WSL (Windows Subsystem for Linux).

• Follow this guide to install WSL.
• Then, follow the Linux (APT) setup guide to install the teleoperation server.

​

Support