Skip to main content

Installation

This page provides basic information about how to install the Project Aria Tools library as a Python package using pip. For more advanced installation options including installing CMake / Python package from source code, please refer to the Advanced Installation page.

Installing projectaria-tools​

Select your preferences
We’ll generate the right install command
Operating System
Package
Channel
Dev channel is unavailable when using pip.
Install Command
rm -rf $HOME/projectaria_gen2_python_env
python3 -m venv $HOME/projectaria_gen2_python_env
source $HOME/projectaria_gen2_python_env/bin/activate

python3 -m pip install projectaria-tools'[all]'==2.0.0

Use the above table to get the exact command to install projectaria-tools library.

  • We strongly recommend install projectaria-tools via pip packages within a Python virtual environment.
  • stable represents the most currently tested and supported version of PyTorch. This should be suitable for many users; develop is pushed continuously to the main branch on Github repo.
  • For users who wants to build the library from source code (C++ or Python), please refer to instructions in the advanced installation page.

Supported Platforms​

OS / PlatformOS / Distro DetailsAria Gen2 Support (projectaria-tools ≥2.0)Supported Python Versions
Linux (x64)Fedora 40/41; Ubuntu 20.04 LTS (focal) / 22.04 LTS (jammy)✅ Supported3.9 – 3.12
macOS (Apple Silicon / ARM64)macOS 14+ (Sonoma or newer) on M1/M2/M3✅ Supported3.10 – 3.12
macOS (Intel)macOS 13+ (Ventura or newer)✅ Supported3.9 – 3.12
Windows (x64)MSVC 2019/2022🚧 Planned3.10 – 3.12