Get the Current Stage#

USD itself does not currently have a notion of a user session associated with a current stage. This is handled by higher-level facilities in USD applications such as usdviewApi in USDView and omni.usd in Omniverse Kit.

from pxr import Usd
import omni.usd

def get_current_stage() -> Usd.Stage:
    return omni.usd.get_context().get_stage()


#############
# Full Usage
#############
# Create a new USD stage through the UsdContext
success: bool = omni.usd.get_context().new_stage()

# Get the the current stage from the UsdContext
current_stage: Usd.Stage = get_current_stage()

# Check if the a new stage was created and a valid stage was returned
assert success
assert current_stage

usdview Python interpreter has a built-in object called usdviewApi that gives you access to the currently loaded Stage.

from pxr import Usd

stage: Usd.Stage = usdviewApi.stage