urbanverse-scene 0.1.0

Python API for UrbanVerse urban scene datasets on HuggingFace (CraftBench & UrbanVerse-Scenes)

urbanverse-scene

Python API for downloading, exploring, and using UrbanVerse urban scene datasets hosted on HuggingFace.

Dataset	Scenes	HuggingFace
CraftBench	12 hand-crafted testing scenes	Oatmealliu/UrbanVerse-CraftBench
UrbanVerse-Scenes	320 generated training scenes	Oatmealliu/UrbanVerse-Scenes

Installation

pip install urbanverse-scene --extra-index-url https://pypi.nvidia.com

The --extra-index-url flag is required because isaacsim is hosted on NVIDIA's PyPI index.

Quick start

import urbanverse_scene as uvs

# (Optional) Override cache directory (default: ~/.cache/urbanverse_scenes/)
uvs.set("~/my_data/urbanverse_scenes")

# List available CraftBench scenes
descs = uvs.craftbench.get_descriptions()

# Download & extract specific scenes
result = uvs.craftbench.load_scenes(descs[:2])
usd_path = result[descs[0]]  # Path to export_version.usd

# Download all 12 CraftBench scenes
uvs.craftbench.download_all()

# Check download integrity & repair missing files
uvs.craftbench.check_integrity()
uvs.craftbench.repair()

# Preview scenes in the browser (video + images)
uvs.craftbench.preview(descs[:3])

# Open scenes in IsaacSim
uvs.open(descs[:1])
uvs.open(descs[:1], headless=True, rtx=True)

API overview

Function	Description
uvs.set(path)	Set the local cache directory
uvs.open(descriptions, headless, rtx)	Open scenes in IsaacSim
uvs.craftbench.get_descriptions()	List all 12 CraftBench scene names
uvs.craftbench.load_scenes(descriptions)	Download & extract specific scenes
uvs.craftbench.download_all()	Download the full CraftBench dataset
uvs.craftbench.check_integrity()	Verify download completeness
uvs.craftbench.repair()	Re-download missing files
uvs.craftbench.preview(descriptions)	Browser-based scene preview (video + images)

Requirements

• Python >= 3.8
• IsaacSim 4.5.0 (installed automatically as a dependency; requires NVIDIA's extra index)
• huggingface_hub >= 0.34.4

License

MIT

Links

• UrbanVerse Project
• GitHub Repository
• CraftBench Dataset
• UrbanVerse-Scenes Dataset