Install & Compatibility
Where this runs
tested against v2.1.4 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
py 3.10
✕ build_error
✓ 40.8s
py 3.11
✕ build_error
✓ 40.8s
py 3.12
✕ build_error
✓ 36.7s
py 3.13
✕ build_error
✕ build_error
py 3.9
✕ build_error
✓ 45.2s
1331MB installed
● package 1331MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
VrsDataProvider
✓ from projectaria_tools.core.data_provider import VrsDataProvider
✗ from projectaria_tools import VrsDataProvider
VrsDataProvider is in the core.data_provider submodule
AriaDigitalTwinClient
✓ from projectaria_tools.core.adt_utils import AriaDigitalTwinClient
✗ from projectaria_tools.adt import AriaDigitalTwinClient
ADT utilities are in core.adt_utils
MpsDataProvider
✓ from projectaria_tools.core.mps import MpsDataProvider
✗ from projectaria_tools.mps import MpsDataProvider
MPS data provider is in core.mps
Basic usage to open a VRS file, list streams, and read first image data.
from projectaria_tools.core.data_provider import VrsDataProvider
from projectaria_tools.core.calibration import device_calibration_from_json_str
import os
# Provide path to a .vrs file (replace with your own)
vrs_filepath = os.environ.get('VRS_FILE', '')
if not vrs_filepath:
raise ValueError('Set VRS_FILE environment variable')
dp = VrsDataProvider(vrs_filepath)
print('Stream IDs:', dp.get_all_stream_ids())
# Read the first time series from stream 211-1 (RGB camera)
stream_id = '211-1'
dp.set_stream_player(stream_id)
dp.play()
first_timestamp, first_data = dp.read_next()
print('First timestamp (ns):', first_timestamp)
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'projectaria_tools'
Library not installed or installed in wrong environment.
fixRun: pip install projectaria-tools
ImportError: cannot import name 'VrsDataProvider' from 'projectaria_tools'
Importing from the top-level package instead of submodule.
fixUse: from projectaria_tools.core.data_provider import VrsDataProvider
RuntimeError: VRS file not found or invalid: <path>
The provided file path does not exist or is not a valid .vrs file.
fixCheck file path and ensure it is a Project Aria VRS recording.
Upgrade
Version history
2.1.4latest on PyPI · released Jun 11, 2026
Audit
Dependencies
numpyrequiredCore dependency for array operations
opencv-pythonoptionalImage processing and display
matplotliboptionalPlotting and visualization