3.2 KiB
Installation
Of the Pepper Robot Interface on macOS.
Python 2.7
Install Python 2.7.18 from the Python website.
Check that it worked by executing
python2 -V
Which should return Python 2.7.18.
Virtual Environment
Next, cd into this repository and create (and activate) a virtual environment:
cd /path/to/project/
python2 -m pip install virtualenv
python2 -m virtualenv .venv
source .venv/bin/activate
We depend on PortAudio for the pyaudio package. If on Intel, run brew install portaudio. If on Apple Silicon, compile manually using the steps described in the YouTrack article.
Then install the required Python packages with
pip install -r requirements.txt
NaoQi SDK
We need to manually install the NaoQi SDK into our virtual environment. There are two options:
- Install a newer version (2.8) which will make running easier, but compatibility is uncertain.
- Install the version expected by the robot (2.5). This will complicate running slightly.
Option 1
Download the SDK from twirre.io, or find one on the Aldebaran website, or an archived version on Web Archive.
Extract it to /path/to/project/.venv/lib/python2.7/site-packages/.
We need to inform our virtual environment where to find our newly installed package:
echo "/path/to/project/.venv/lib/python2.7/site-packages/pynaoqi-python2.7-2.8.6.23-mac64-20191127_144231/lib/python2.7/site-packages/" > /path/to/project/.venv/lib/python2.7/site-packages/pynaoqi-python2.7.pth
Now continue with verifying.
Option 2
This method of installation requires setting the DYLD_LIBRARY_PATH environment variable before running. How will be explained.
Download the SDK from twirre.io. This is a modified version of the one from Aldebaran, this one including required Choregraphe dependencies.
Extract it to /path/to/project/.venv/lib/python2.7/site-packages/.
We need to inform our virtual environment where to find our newly installed package:
echo "/path/to/project/.venv/lib/python2.7/site-packages/pynaoqi-python2.7-2.5.7.1-mac64/lib/python2.7/site-packages/" > /path/to/project/.venv/lib/python2.7/site-packages/pynaoqi-python2.7.pth
Now, anytime before running you need to set the DYLD_LIBRARY_PATH environment variable.
export DYLD_LIBRARY_PATH="/path/to/project/.venv/lib/python2.7/site-packages/pynaoqi-python2.7-2.5.7.1-mac64/choregraphe_lib:${DYLD_LIBRARY_PATH}"
You may want to simplify environment activation with a script activate.sh like:
#!/bin/zsh
export DYLD_LIBRARY_PATH="/path/to/project/.venv/lib/python2.7/site-packages/pynaoqi-python2.7-2.8.6.23-mac64-20191127_144231/choregraphe_lib:${DYLD_LIBRARY_PATH}"
source .venv/bin/activate
Verify if it works.
Verifying
Verify that the NaoQI SDK installation works with
python -c "import qi; print(qi)"
If so, you should now be able to run this project.
See the README for how to run.