Use when working with the Aria Client SDK - device pairing, recording, streaming, CLI commands (aria_gen2), Python SDK (aria.sdk_gen2), streaming visualization, multi-device time domain mapping, and device…
---
name: client-sdk
description: Use when working with the Aria Client SDK — device pairing, recording, streaming, CLI commands (aria_gen2), Python SDK (aria.sdk_gen2), streaming visualization, multi-device time domain mapping, and device management. Use whenever the user mentions aria_gen2 CLI, aria.sdk_gen2, device pairing, recording start/stop, streaming from Aria glasses, or asks about controlling Aria Gen2 devices programmatically.
---
# Aria Client SDK
The Client SDK lets you control Aria Gen2 glasses from a host PC — pair devices, manage recordings, stream live sensor data, and configure multi-device setups. It ships as a pip package with both a CLI (`aria_gen2`) and a Python SDK (`aria.sdk_gen2`).
## How to Use This Skill
This skill teaches the concepts and capabilities. For exact API details:
- **CLI**: `aria_gen2 <subcommand> --help`
- **Python SDK**: Read `sdk_gen2.pyi` in the installed package (`site-packages/aria/`), or run `help(aria.sdk_gen2)`
- **Sample scripts**: `python -m aria.extract_sdk_samples --output ~/Downloads/`
## Installation
- **Install**: `pip install projectaria-client-sdk` (in a virtual environment, Python 3.10–3.12)
- **Verify**: `aria_doctor` — configures system ports and verifies connectivity
- **Supported**: Linux x64 (Ubuntu/Fedora), macOS Apple Silicon
- **Docs**: https://facebookresearch.github.io/projectaria_tools/gen2/ark/client-sdk/start
## Prerequisites