USD Validation NVIDIA
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.
It is the standalone successor to omniverse-asset-validator and is intended for use in any USD pipeline.
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 usd-validation-nvidia
Optional Dependencies
For full functionality, install with optional dependencies:
# Include usd-core
pip install usd-validation-nvidia[usd]
# Include USD Exchange
pip install usd-validation-nvidia[usdex]
# Include NumPy (for optimizations)
pip install usd-validation-nvidia[numpy]
# Install all optional dependencies
pip install usd-validation-nvidia[usd,numpy]
Repository Layout and Releases
This repository is the single source repository for the shared NSPECT release and publishes
two Python packages from the same commit, both versioned from the shared VERSION.md:
usd-validation-nvidia— the validation engine (source undervalidation/src/, with package docs, examples, and tests undervalidation/)usd-profiles-nvidia— profile/spec definitions and code generation tooling (profiles/directory, auvworkspace member; formerly a standalone repository)
uv build --all-packages produces wheels and sdists for both packages.
Build from Source
Generate the capabilities package with the in-repo profiles/ member (usd-profiles-nvidia), then build the wheel:
uv run \
--no-project \
--with ./profiles \
python -m usd_profiles_nvidia.codegen \
--docs-root specs \
--destination-dir validation/src \
--package-name usd_validation_nvidia.capabilities \
--reverse-domain com.nvidia.usd
uv build --all-packages -o dist
Basic usage
from usd_validation_nvidia import ValidationEngine, IssueFixer
engine = ValidationEngine()
asset = "path/to/asset.usda"
results = engine.validate(asset)
for issue in results.issues():
print(f"{issue.severity}: {issue.message}")
fixer = IssueFixer(asset)
fix_results = fixer.fix(results.issues())
for result in fix_results:
print(f"{result.status}: {result.issue.message}")
fixer.save()
The ValidationEngine also supports selecting specific rules with enable_rule() / disable_rule().
To filter by category in Python, enable the rules returned by CategoryRuleRegistry().get_rules(category).
ValidationEngine also supports async validation, and rule Check* callbacks may be declared
async def; see
Running rules asynchronously.
Command Line Interface
The nvidia_usd_validate command provides validation from the terminal:
# Validate a single file
nvidia_usd_validate asset.usda
# Validate a directory recursively
nvidia_usd_validate ./assets/
# Apply automatic fixes
nvidia_usd_validate --fix asset.usda
# Validate specific categories
nvidia_usd_validate --category Material --category Geometry asset.usda
# Enable specific rules only
nvidia_usd_validate --no-init-rules --rule StageMetadataChecker asset.usda
# Export results to CSV
nvidia_usd_validate --csv-output results.csv asset.usda
# Show help
nvidia_usd_validate --help
Exit codes
By default, nvidia_usd_validate exits with the following status codes:
0when validation completes without issues.1when validation issues are found or a requested report cannot be written.2when command-line arguments are invalid.
--exit-zero causes validation issues to exit with a status code of 0. Execution errors and report-write failures
still exit with a status code of 1, while invalid command-line arguments still exit with a status code of 2.
Use --no-exit-zero to explicitly retain the default behavior.
Documentation
Requirements
- Python 3.10 - 3.13 with OpenUSD 23.11 or later
- Python 3.10 - 3.13 with USD Exchange 3.0.0 or later
- Python 3.14 with OpenUSD 26.08
License
Apache-2.0 AND CC-BY-4.0
AI Coding Agents
The AGENTS.md file and .agents/skills directory contain structured guidance for AI coding agents. Start there for Python project setup, local venv setup, and generated requirement validation workflows.
Metadata
Release files for usd-validation-nvidia 1.23.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| usd_validation_nvidia-1.23.0-py3-none-any.whl | Python 3 | none | any | Details for usd_validation_nvidia-1.23.0-py3-none-any.whl |
Release files / usd_validation_nvidia-1.23.0-py3-none-any.whl
| Download URL | usd_validation_nvidia-1.23.0-py3-none-any.whl |
|---|---|
| Size | 363.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
42b10d1221e0bb07854bbb98f0dc4e79084bb274e36f550524abcda9c7a48970
|
|
BLAKE2b-256 checksum How to use checksums |
cb9e371538c3f16b6c9913e9bad96b8614081dd568c21457d6ee06d1f02bbd5d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.8
|
Security for usd-validation-nvidia 1.23.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.