{"library":"nuscenes-devkit","title":"NuScenes Devkit","description":"The NuScenes Devkit is the official Python toolkit for interacting with the NuScenes dataset, a large-scale dataset for autonomous driving. It provides functionalities for loading, processing, visualizing, and evaluating data from the NuScenes and NuImages datasets. The current version is 1.2.0, with a release cadence that includes several minor updates and bug fixes per year, alongside occasional major updates for new dataset releases or features.","language":"python","status":"active","last_verified":"Mon May 18","install":{"commands":["pip install nuscenes-devkit","pip install 'nuscenes-devkit[dl]'"],"cli":{"name":"nuscenes","version":"sh: 1: nuscenes: not found"}},"imports":["from nuscenes.nuscenes import NuScenes","from nuscenes.nuscenes_explorer import NuScenesExplorer","from nuscenes.nuscenes_map import NuScenesMap"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom nuscenes.nuscenes import NuScenes\n\n# IMPORTANT: Before running, you must download a NuScenes dataset split\n# (e.g., v1.0-mini) from www.nuscenes.org and extract it.\n# The 'dataroot' should point to the directory containing 'sets/nuscenes'.\n# Example directory structure: /your/chosen/root/sets/nuscenes/v1.0-mini\n\n# Replace with the actual path to your NuScenes data root directory\ndataroot = os.environ.get('NUSCENES_DATAROOT', '/tmp/nuscenes_data_root')\n# Replace with the dataset version you downloaded (e.g., 'v1.0-trainval', 'v1.0-mini')\nversion = os.environ.get('NUSCENES_VERSION', 'v1.0-mini')\n\ntry:\n    # Initialize the NuScenes object\n    nusc = NuScenes(version=version, dataroot=dataroot, verbose=True)\n    print(f\"Successfully loaded NuScenes dataset version '{nusc.version}' from '{nusc.dataroot}'\")\n\n    # Print some basic statistics\n    print(f\"Number of scenes: {len(nusc.scene)}\")\n    print(f\"Number of samples: {len(nusc.sample)}\")\n\n    # Example: Access the first scene\n    first_scene = nusc.scene[0]\n    print(f\"\\nFirst scene name: {first_scene['name']}\")\n    print(f\"First scene description: {first_scene['description']}\")\n\nexcept ValueError as e:\n    print(f\"Error initializing NuScenes: {e}\")\n    print(\"Please ensure 'dataroot' and 'version' are correctly set and the dataset is downloaded.\")\nexcept FileNotFoundError as e:\n    print(f\"Error loading NuScenes data: {e}\")\n    print(\"Ensure the dataset is extracted and 'dataroot' points to the correct location.\")\n    print(\"Expected structure inside dataroot: sets/nuscenes/<version>/\")\nexcept Exception as e:\n    print(f\"An unexpected error occurred: {e}\")","lang":"python","description":"This quickstart demonstrates how to initialize the `NuScenes` object, which is the primary entry point for interacting with the dataset. It highlights the critical `dataroot` and `version` parameters, which must correspond to your locally downloaded and extracted NuScenes data. The code also includes basic error handling for common setup issues.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-18","installed_version":"1.2.0","pypi_latest":"1.2.0","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":40,"avg_install_s":17,"avg_import_s":5.18,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"dl","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"nuscenes-devkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"dl","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":18,"import_time_s":3.66,"mem_mb":64.3,"disk_size":"511M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"nuscenes-devkit","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":18.3,"import_time_s":3.61,"mem_mb":64.3,"disk_size":"511M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"dl","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"nuscenes-devkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"dl","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":14.8,"import_time_s":6.33,"mem_mb":76,"disk_size":"538M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"nuscenes-devkit","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":15.1,"import_time_s":6.11,"mem_mb":76,"disk_size":"538M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"dl","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"nuscenes-devkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"dl","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":15,"import_time_s":6.78,"mem_mb":74.6,"disk_size":"519M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"nuscenes-devkit","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":15.3,"import_time_s":6.84,"mem_mb":74.6,"disk_size":"519M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"dl","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"nuscenes-devkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"dl","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":6.9,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"nuscenes-devkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":7.2,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"dl","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"nuscenes-devkit","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"dl","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":19.8,"import_time_s":3.97,"mem_mb":60.6,"disk_size":"512M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"nuscenes-devkit","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":19.7,"import_time_s":4.18,"mem_mb":60.6,"disk_size":"512M"}]}}