{"id":23145,"library":"projectaria-tools","title":"Project Aria Tools","description":"A library from Meta Reality Labs for processing and visualizing data from Project Aria glasses. Supports Aria Gen1 and Gen2 VRS data, on-device machine perception (MPS), and provides C++ and Python APIs. Current version 2.1.2, requires Python >=3.8, released under MIT license.","status":"active","version":"2.1.2","language":"python","source_language":"en","source_url":"https://github.com/facebookresearch/projectaria_tools","tags":["augmented-reality","slam","computer-vision","data-processing","meta","project-aria"],"install":[{"cmd":"pip install projectaria-tools","lang":"bash","label":"Standard install"}],"dependencies":[{"reason":"Core dependency for array operations","package":"numpy","optional":false},{"reason":"Image processing and display","package":"opencv-python","optional":true},{"reason":"Plotting and visualization","package":"matplotlib","optional":true}],"imports":[{"note":"VrsDataProvider is in the core.data_provider submodule","wrong":"from projectaria_tools import VrsDataProvider","symbol":"VrsDataProvider","correct":"from projectaria_tools.core.data_provider import VrsDataProvider"},{"note":"ADT utilities are in core.adt_utils","wrong":"from projectaria_tools.adt import AriaDigitalTwinClient","symbol":"AriaDigitalTwinClient","correct":"from projectaria_tools.core.adt_utils import AriaDigitalTwinClient"},{"note":"MPS data provider is in core.mps","wrong":"from projectaria_tools.mps import MpsDataProvider","symbol":"MpsDataProvider","correct":"from projectaria_tools.core.mps import MpsDataProvider"}],"quickstart":{"code":"from projectaria_tools.core.data_provider import VrsDataProvider\nfrom projectaria_tools.core.calibration import device_calibration_from_json_str\nimport os\n\n# Provide path to a .vrs file (replace with your own)\nvrs_filepath = os.environ.get('VRS_FILE', '')\nif not vrs_filepath:\n    raise ValueError('Set VRS_FILE environment variable')\n\ndp = VrsDataProvider(vrs_filepath)\nprint('Stream IDs:', dp.get_all_stream_ids())\n# Read the first time series from stream 211-1 (RGB camera)\nstream_id = '211-1'\ndp.set_stream_player(stream_id)\ndp.play()\nfirst_timestamp, first_data = dp.read_next()\nprint('First timestamp (ns):', first_timestamp)","lang":"python","description":"Basic usage to open a VRS file, list streams, and read first image data."},"warnings":[{"fix":"Update imports to use projectaria_tools.core.* submodules instead of old top-level imports.","message":"v2.0.0 introduced breaking changes in API for Gen1 data. Some functions were moved or renamed. Users of v1.x must update import paths.","severity":"breaking","affected_versions":"<2.0.0"},{"fix":"Replace poseplayer usage with projectaria_tools.core.mps.MpsDataProvider.","message":"The legacy poseplayer module was removed in v1.5.8. Use MpsDataProvider for SLAM/pose data instead.","severity":"deprecated","affected_versions":">=1.5.8"},{"fix":"Always pass stream IDs as strings, e.g., '211-1', '1201-1', etc.","message":"Stream IDs are strings like '211-1' for RGB camera. Using integers or different format leads to ValueError.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run: pip install projectaria-tools","cause":"Library not installed or installed in wrong environment.","error":"ModuleNotFoundError: No module named 'projectaria_tools'"},{"fix":"Use: from projectaria_tools.core.data_provider import VrsDataProvider","cause":"Importing from the top-level package instead of submodule.","error":"ImportError: cannot import name 'VrsDataProvider' from 'projectaria_tools'"},{"fix":"Check file path and ensure it is a Project Aria VRS recording.","cause":"The provided file path does not exist or is not a valid .vrs file.","error":"RuntimeError: VRS file not found or invalid: <path>"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}