Installation - Linux¶
Prerequisites¶
Vector is powered on.
You have successfully created an Anki account.
Vector has been set up with the Vector companion app.
The Vector companion app is not currently connected to Vector.
Vector is connected to the same network as your computer.
You can see Vector’s eyes on his screen.
This guide provides instructions on installing the Vector SDK for computers running with an Ubuntu Linux operating system.
Warning
The Vector SDK is tested and and supported on Ubuntu 18.04 and 16.04. Anki makes no guarantee the Vector SDK will work on other versions of Linux. If you wish to try the Vector SDK on versions of Linux other than Ubuntu 18.04 or 16.04, please ensure the following dependencies are installed:
Python 3.6.1 or later
pip for Python 3 (Python package installer)
Ubuntu 18.04¶
Python Installation¶
Type the following into your Terminal window to install Python:
sudo apt-get update sudo apt-get install python3
Then install pip by typing in the following into the Terminal window:
sudo apt install python3-pip
Last, install Tkinter:
sudo apt-get install python3-pil.imagetk
SDK Installation¶
To install the SDK, type the following into the Terminal window:
python3 -m pip install --user ikkez_vector
SDK Upgrade¶
To upgrade the SDK from a previous install, enter this command:
python3 -m pip install --user --upgrade ikkez_vector
Vector Authentication¶
To authenticate with the robot, type the following into the Terminal window. Note that during this configure step, your password will not show by design as a security precaution:
python3 -m anki_vector.configure
You will be prompted for your robot’s name, ip address and serial number. You will also be asked for your Anki login and password. Make sure to use the same account that was used to set up your Vector.
You will see “SUCCESS!” when this script successfully completes.
Note
By running the anki_vector.configure executable submodule, you will be asked to provide your Anki account credentials, and the script will automatically download an authentication token and certificate to your computer that will grant you access to the robot and his capabilities (such as camera and audio) as well as data stored on the robot (such as faces and photos).
The downloaded access token is equivalent to your account credentials. It will be stored in your user directory (~/.anki_vector) along with a robot identity certificate and other useful data for establishing a connection. Do not share your access token.
Warning
These credentials give full access to your robot, including camera stream, audio stream and data. Do not share these credentials.
Ubuntu 16.04¶
Python and Module Installation¶
Type the following into your Terminal window to install Python 3.6:
sudo add-apt-repository ppa:deadsnakes/ppa sudo apt-get update sudo apt-get install python3.6
Then install pip by typing in the following into the Terminal window:
sudo apt install python3-pip
Install the following additional packages:
sudo apt-get install build-essential libssl-dev libffi-dev python3.6-dev python3-pil.imagetk
SDK Installation¶
To install the SDK, type the following into the Terminal window:
python3.6 -m pip install --user anki_vector
SDK Upgrade¶
To upgrade the SDK from a previous install, enter this command:
python3.6 -m pip install --user --upgrade anki_vector
Vector Authentication¶
To authenticate with the robot, type the following into the Terminal window. Note that during this configure step, your password will not show by design as a security precaution:
python3.6 -m anki_vector.configure
You will be prompted for your robot’s name, ip address and serial number. You will also be asked for your Anki login and password. Make sure to use the same account that was used to set up your Vector.
You will see “SUCCESS!” when this script successfully completes.
Note
By running the anki_vector.configure executable submodule, you will be asked to provide your Anki account credentials, and the script will automatically download an authentication token and certificate to your computer that will grant you access to the robot and his capabilities (such as camera and audio) as well as data stored on the robot (such as faces and photos).
The downloaded access token is equivalent to your account credentials. It will be stored in your user directory (~/.anki_vector) along with a robot identity certificate and other useful data for establishing a connection. Do not share your access token.
Warning
These credentials give full access to your robot, including camera stream, audio stream and data. Do not share these credentials.
Troubleshooting¶
Please see the Troubleshooting page for tips, or visit the Anki Developer Forums to ask questions, find solutions, or for general discussion.