Installation
Install the Client SDK to control and interact with Aria Gen 2 devices from your PC.
Prerequisites
- Hardware: Aria Gen 2 device
- Mobile App: Aria Companion App installed and paired with your device (setup guide)
- Connection: USB cable for device-to-PC connection
Supported Platforms
| OS / Platform | OS / Distro Details | Aria Gen2 Support (projectaria-tools ≥2.0) | Supported Python Versions |
|---|---|---|---|
| Linux (x64) | Fedora 40/41; Ubuntu 22.04 LTS (jammy) / 24.04 LTS ( Noble Numbat) | ✅ Supported | 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) | macOS 13 (Ventura) | ❌ Deprecated | 3.10 – 3.12 |
| Windows (x64) | MSVC 2019/2022 | 🚧 Planned | 3.10 – 3.12 |
Ubuntu 22.04 Known Issue
If you encounter a GLIBCXX_3.4.31 not found error when running CLI commands on Ubuntu 22.04, you'll need to update your C++ standard library.
See the GLIBCXX troubleshooting guide for the solution.
Step 1: Install Python
To use the Client SDK, you'll need Python 3.10 - 3.12.
- Python 3 download page
- To check what version of Python 3 you have, use
python3 --version
Step 2: Create a Virtual Environment
- Linux & macOS
rm -rf $HOME/projectaria_gen2_python_env
python3 -m venv $HOME/projectaria_gen2_python_env
source $HOME/projectaria_gen2_python_env/bin/activate
Step 3: Install the Client SDK Python Package
pip install projectaria-client-sdk
Verify Installation
After installation, run aria_doctor to configure your system and verify the SDK is working:
aria_doctor
Expected behavior: The command opens required ports on your PC for device discovery and configures your system to allow unblocked internet connection.
Available CLI Controls
The Client SDK provides a CLI to control your Aria Gen 2 device:
- Recording: Start, stop, list, and download recordings in VRS format
- Streaming: Start and stop streaming sensor data
- Device: Obtain device information, connect to Wi-Fi, send text-to-speech, and more
See the CLI Quick Reference for a command overview or the Technical Specs for the full reference.
Next Steps
- Authenticate your device to enable SDK access
- Explore Recording to capture data
- Check out Streaming to stream data in real-time