{"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,"search_vec":"'2.1.2':40 '3.8':43 'api':37 'aria':2,17,20,61 'augment':49 'augmented-r':48 'c':34 'comput':53 'computer-vis':52 'current':38 'data':14,25,56 'data-process':55 'devic':28 'gen1':21 'gen2':23 'glass':18 'lab':9 'librari':5 'licens':47 'machin':29 'meta':7,58 'mit':46 'mps':31 'on-devic':26 'percept':30 'process':11,57 'project':1,16,60 'project-aria':59 'provid':33 'python':36,42 'realiti':8,50 'releas':44 'requir':41 'slam':51 'support':19 'tool':3 'version':39 'vision':54 'visual':13 'vrs':24","created_at":"2026-05-01T06:02:39.861793+00:00","updated_at":"2026-05-01T06:02:39.861793+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"2.1.4","cli_name":"","cli_version":null,"type":"library","homepage":"https://facebookresearch.github.io/projectaria_tools/","github":"https://github.com/facebookresearch/projectaria_tools","docs":null,"changelog":null,"pypi":"https://pypi.org/project/projectaria-tools/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","ai-ml"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}