Mps

---
name: mps
description: Use when working with Aria Machine Perception Services (MPS) — cloud-based processing of Aria VRS recordings for SLAM trajectories, hand tracking, semi-dense point clouds, and online calibration. Covers the aria_mps CLI, single and multi-sequence processing, output formats, data lifecycle, and loading MPS results with ProjectAriaTools. Use whenever the user mentions MPS, aria_mps, SLAM processing, cloud hand tracking, trajectory generation, or submitting VRS files for processing.
---

# Machine Perception Services (MPS)

MPS is a cloud-based post-processing service for Aria recordings. You submit VRS files via the `aria_mps` CLI, MPS runs proprietary Spatial AI algorithms, and you download the derived outputs (trajectories, point clouds, hand tracking). The data is only used to serve requests — not accessible to Meta researchers.

## How to Use This Skill

This skill teaches concepts and capabilities. For details, use the authoritative sources:

- **CLI**: `aria_mps --help`, `aria_mps single --help`, `aria_mps multi --help`
- **Data formats, coordinate conventions, CSV columns**: https://facebookresearch.github.io/projectaria_tools/gen2/technical-specs/mps/data_formats
- **CLI workflow details**: https://facebookresearch.github.io/projectaria_tools/gen2/technical-specs/mps/mps_cli_guide
- **Service versions and algorithm details**: https://facebookresearch.github.io/projectaria_tools/gen2/ark/mps/mps_versioning
- **Benchmarks and performance**: https://facebookresearch.github.io/projectaria_tools/gen2/technical-specs/mps/benchmarks/performance
- **Python API for loading results**: Read `help(projectaria_tools.core.mps)` or `MpsPyBind.h` in the cloned repo. See the projectaria-tools skill.

## Installation

- **Install**: `pip install projectaria-mps` (automatically includes `projectaria-tools` and `projectaria-vrs-health-check`)
- **CLI command**: `aria_mps`
- **Auth**: On first run, authenticate with your Project Aria account. Tokens are cached in the system keychain for subsequent runs.