ModuleNotFoundError: No module named 'omni.usd'

[william2023gbr]

Isaac Sim Version

4.2.0

Operating System

Ubuntu 22.04

Topic Description

Detailed Description

I installed Isaac Sim 4.2.0 using pip within a Conda environment on Ubuntu 22.04. I was trying to use the omni.usd module in a standalone Python script. However, I encountered ModuleNotFoundError: No module named ‘omni.usd’. I was able to import omni.usd inside the Isaac Sim Script Editor, but I need to access it through external Python scripts.

Steps to Reproduce

1. Install Isaac Sim via pip install isaac-sim in a Conda environment.

2. Attempt to import the module using:

/path/to/isaac-sim-4.2.0/python.sh -c "import omni.usd; print('Omni USD loaded successfully')"

Error Messages

ModuleNotFoundError: No module named ‘omni.usd’

Additional Information

What I’ve Tried

• Ensured all PYTHONPATH variables were set as per setup_python_env.sh.

• Sourced both setup_conda_env.sh and setup_python_env.sh.

• Checked that omni.usd works inside Isaac Sim’s Script Editor.

• Reinstalled Isaac Sim and dependencies multiple times using pip.

Additional Context

I need to know if omni.usd is intended for external Python use or if it’s restricted to Isaac Sim’s internal runtime only. If it should work externally, please advise on what might be missing or misconfigured.

[VickNV]

Please refer to the following note on Python Environment — Omniverse IsaacSim latest documentation :

Any Omniverse level imports must occur after the class is instantiated. Because APIs are provided by the extension/runtime plugin system, it must be loaded before they will be available to import.

[william2023gbr]

Thank you!