Implementation:Facebookresearch Habitat lab Hitl defaults config

Knowledge Sources	Habitat-Lab
Domains	Human_in_the_Loop, Configuration_Management
Last Updated	2026-02-15 02:00 GMT

Overview

YAML configuration pattern for composing HITL application settings with Habitat environment configuration using Hydra defaults inheritance.

Description

The hitl_defaults.yaml file and the register_hydra_plugin utility establish the configuration schema for all HITL applications. Applications create their own YAML that inherits from this base and adds task-specific configuration (scenes, agents, interaction modes).

Usage

Create a YAML config for your HITL application that uses hitl_defaults as a Hydra default. Override window, networking, and headless settings as needed.

Code Reference

Source Location

• Repository: habitat-lab
• File: habitat-hitl/habitat_hitl/config/hitl_defaults.yaml (133 lines), habitat-hitl/habitat_hitl/core/hydra_utils.py:L1-61

Signature

# hitl_defaults.yaml structure
hitl:
  window:
    width: 1280
    height: 720
  networking:
    enable: false
    port: 8888
    max_client_count: 1
  experimental:
    headless:
      do_headless: false
      target_fps: 30

Import

# No direct import; loaded via Hydra composition
# Application YAML inherits from hitl_defaults
from habitat_hitl.core.hydra_utils import register_hydra_plugin

I/O Contract

Inputs

Name	Type	Required	Description
Application YAML	file	Yes	HITL application config inheriting from hitl_defaults
Hydra overrides	List[str]	No	CLI overrides for window, networking, headless settings

Outputs

Name	Type	Description
config	DictConfig	Composed config with HITL settings + Habitat environment config

Usage Examples

Create HITL Application Config

# my_app/config/my_hitl_app.yaml
defaults:
  - hitl_defaults
  - habitat: habitat_config_base

hitl:
  networking:
    enable: true
    port: 9000
    max_client_count: 2
  experimental:
    headless:
      do_headless: true

Related Pages

Implements Principle

• Principle:Facebookresearch_Habitat_lab_HITL_Application_Configuration

Requires Environment

• Environment:Facebookresearch_Habitat_lab_HITL_Runtime_Environment