We have tested the FlightGoggles Python Client on Ubuntu 18.04 and Python 3.6.

The FlightGoggles Renderer is installed separately from the Client and can run on Ubuntu or Windows.

Installing with Docker (Recommended)

git submodule update --init --recursive
docker build -t pyfg .
./run_docker.sh
python3.6 -m virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
python setup.py install

Once you build the docker container and generate a virtual environment, the FlightGoggles Python Client can be run with the following command:

./run_docker.sh
source venv/bin/activate

Installing with Virtualenv

Before setting the virtual environment, the following libraries have to be installed. (Skip this step if the library is already installed.)

sudo apt-get install -y \
  cmake \
  python3.6-dev \
  python3-pip \
  python3-virtualenv \
  libeigen3-dev \
  libopencv-dev \
  libzmqpp-dev \
  ffmpeg

The virtual environment can be generated using the following command:

git submodule update --init --recursive
python3.6 -m virtualenv venv
source venv/bin/activate
pip install -r requirements.txt
python setup.py install

Once you generate a virtual environment, the FlightGoggles Python Client can be run with the following command:

source venv/bin/activate

Checking the installation

After the installation, run the demo notebook to check the installation. Run the jupyter notebook, and run notebooks/demo_uav.ipynb. (Before running the notebook, set up the docker or virtualenv, and execute FlightGoggles Renderer binary)

Restart the notebook kernel when it returns the error message “Address already in use”.