Project Aria Tools (PAT)

---
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