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
Use the above table to get the exact command to install projectaria-tools library.
- We strongly recommend install
projectaria-toolsviapippackages within a Python virtual environment. stablerepresents the most currently tested and supported version of PyTorch. This should be suitable for many users;developis pushed continuously to themainbranch 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 / Platform | OS / Distro Details | Aria Gen2 Support (projectaria-tools ≥2.0) | Supported Python Versions |
|---|---|---|---|
| Linux (x64) | Ubuntu 22.04 LTS (jammy) / 24.04 LTS (Noble Numbat), and recent Fedora releases. Requires glibc 2.17 or newer | ✅ Supported | 3.10 – 3.12 |
| Linux (ARM64 / aarch64) | e.g. NVIDIA Jetson. Same glibc floor as x64 | 🧪 Experimental | 3.10 – 3.12 |
| macOS (Apple Silicon / ARM64) | macOS 14+ (Sonoma or newer) on M1/M2/M3/M4 | ✅ Supported | 3.10 – 3.12 |
| macOS (Intel / x64) | — | ❌ Not supported | — |
| Windows (x64) | — | 🚧 Planned | — |
Older Linux distributions
The published wheels are manylinux_2_17, so anything with glibc 2.17 or newer — including Ubuntu 20.04 LTS — should install. Only 22.04 and 24.04 are actually tested, so older releases are untested rather than known-good.
Note that projectaria-client-sdk has a higher floor (glibc 2.34, i.e. Ubuntu 22.04+); if you install both, that is the constraint that applies.