Implementation:Facebookresearch Habitat lab Datasets download CLI

Knowledge Sources	Habitat-Sim Habitat-Lab Docs
Domains	Embodied_AI, Data_Management
Last Updated	2026-02-15 02:00 GMT

Overview

CLI tool for downloading 3D scene datasets required by Habitat environments, provided by the habitat-sim package.

Description

The datasets_download utility is a command-line tool from the habitat-sim package that downloads scene datasets (Gibson, MP3D, HM3D, ReplicaCAD) and their associated navigation meshes and episode definitions. It handles authentication, download resumption, and extraction to the standard `data/` directory structure.

Usage

Run this tool before any Habitat training or evaluation workflow to ensure the required 3D scene assets are available locally.

Code Reference

Source Location

• Repository: habitat-sim
• File: External CLI tool (part of habitat-sim package, not habitat-lab)

Signature

python -m habitat_sim.utils.datasets_download \
    --uids <dataset_uid> \
    [--data-path <target_directory>]

Import

# CLI tool, no Python import needed
# Requires: pip install habitat-sim

I/O Contract

Inputs

Name	Type	Required	Description
--uids	str	Yes	Dataset identifier (e.g., `habitat_test_scenes`, `gibson`, `mp3d`, `replica_cad_dataset`, `hssd-hab`)
--data-path	str	No	Target directory for downloaded data (defaults to `data/`)

Outputs

Name	Type	Description
Scene files	.glb files	3D mesh files for each scene
Navigation meshes	.navmesh files	Pre-computed navigation graphs
Episode datasets	.json.gz files	Episode definitions with start/goal positions

Usage Examples

Download Test Scenes

# Download small test scene dataset for development
python -m habitat_sim.utils.datasets_download --uids habitat_test_scenes --data-path data/

Download Gibson Dataset

# Download Gibson scenes for PointNav training
python -m habitat_sim.utils.datasets_download --uids gibson --data-path data/

Download ReplicaCAD for Rearrangement

# Download ReplicaCAD scenes for rearrangement tasks
python -m habitat_sim.utils.datasets_download --uids replica_cad_dataset --data-path data/

Related Pages

Implements Principle

• Principle:Facebookresearch_Habitat_lab_Environment_Setup

Requires Environment

• Environment:Facebookresearch_Habitat_lab_Python_3_9_Core_Dependencies