Omniverse Asset Validator

An extensible framework to validate OpenUSD assets. Inspired by Pixar's usdchecker, this library extends validation capabilities with additional rules and provides automatic issue fixing.

Features

• Rule-based validation — Modular rule interface with registration mechanism for custom validators
• Flexible engine — Run validation on a Usd.Stage, individual layers, or recursively search folders
• Auto-fixing — Issue fixing interface for applying automated corrections when rules provide suggestions
• Command line interface — Standalone CLI for validation outside of GUI applications
• Lightweight — Pure Python implementation requiring only OpenUSD

Installation

Install from PyPI:

pip install omniverse-asset-validator

Optional Dependencies

For full functionality, install with optional dependencies:

# Include usd-core
pip install omniverse-asset-validator[usd]

# Include NumPy (for optimizations)
pip install omniverse-asset-validator[numpy]

# Install all optional dependencies
pip install omniverse-asset-validator[usd,numpy]

Basic usage

from omni.asset_validator import ValidationEngine, IssueFixer

engine = ValidationEngine()
results = engine.validate("path/to/asset.usda")

for issue in results.issues():
    print(f"{issue.severity}: {issue.message}")

fixer = IssueFixer()
fix_results = fixer.fix(results.issues())

for result in fix_results:
    print(f"{result.status}: {result.issue.message}")

The ValidationEngine also supports selecting specific rules with enableRule() / disableRule() and filtering by category with enableCategory().

Command Line Interface

The omni_asset_validate command provides validation from the terminal:

# Validate a single file
omni_asset_validate asset.usda

# Validate a directory recursively
omni_asset_validate ./assets/

# Apply automatic fixes
omni_asset_validate --fix asset.usda

# Validate specific categories
omni_asset_validate --category Material --category Geometry asset.usda

# Enable specific rules only
omni_asset_validate --no-init-rules --rule StageMetadataChecker asset.usda

# Export results to CSV
omni_asset_validate --csv-output results.csv asset.usda

# Show help
omni_asset_validate --help

Documentation

• Full Documentation
• API Reference
• Available Rules

Requirements

• Python 3.10 - 3.12
• OpenUSD 22.11 or later

License

Apache-2.0