Use when working with projectaria_tools (PAT) - the official Python/C++ library for reading Aria VRS recordings, accessing sensor data, device calibration, loading MPS results (eye gaze, hand tracking, SLAM…
---
name: projectaria-tools
description: Use when working with projectaria_tools (PAT) — the official Python/C++ library for reading Aria VRS recordings, accessing sensor data, device calibration, loading MPS results (eye gaze, hand tracking, SLAM trajectory), time domain mapping for multi-device alignment, and data visualization. Use whenever the user imports projectaria_tools, works with Aria VRS files, or asks about Aria sensor data processing.
---
# ProjectAriaTools (PAT)
PAT is the foundational open-source library for accessing and processing data recorded by Project Aria glasses. It provides Python and C++ interfaces for loading VRS files, accessing calibration, processing sensor data, loading MPS results, and visualizing Aria data.
## How to Use This Skill
This skill is a navigation map — it tells you where the key APIs and source files are, what the gotchas are, and where to find the truth. **Never guess API names from this skill alone.** Read the source file it points to before writing any API call.
- For CLI flags, run `--help` instead of guessing from this skill.
- For API details, read the relevant Python module or C++ pybind header.
## Installation & Documentation
- **GitHub**: https://github.com/facebookresearch/projectaria_tools
- **Docs**: https://facebookresearch.github.io/projectaria_tools/gen2/research-tools/projectariatools/overview
- **Install** (pip in a virtual environment):
```bash
python3 -m venv $HOME/projectaria_gen2_python_env
source $HOME/projectaria_gen2_python_env/bin/activate