AYON USD Resolver

Introduction

The AYON USD Resolver is an asset resolver plugin for Pixar's USD. It's designed to turn URIs with the ayon:// or ayon+entity:// formats into local file paths.

This resolver uses local caching and connects with the AYON Server to handle AYON compatible entity URIs through the AyonCppApi.

Important

This repository uses Git Submodules. Make sure to use the correct git clone commands accordingly.
git clone --recurse-submodules https://github.com/ynput/ayon-usd-resolver.git
git submodule update --init --recursive

Important

The AYON USD Resolver is an AR2.0 resolver and will not support AR1.0 resolution. Make sure that your software package is compatible with the AR2.0 standard or use the defaults we provide in the AYON Usd Addon

NOTE
Admin and Dev docs can be found under /Docs/Ayon_Docs/

Repository Docs

Requirements:

• C++ Compiler
• Cmake
• Target DCC / SDK installed
• python3 development files (Optional when building Against AYON Usd)

Tested Platforms:

• Rocky 9 Linux

  • Hou 21.0.631
  • Hou 21.0.512
  • Hou 20.5.892
  • Hou 20.5.654
  • Hou 20.0.1358
  • Hou 20.0.896
  • Hou 19.5.805
  • Hou 19.5.773
  • Maya 2026 (UsdAddon_0.25.5)
  • Maya 2025
  • Maya 2024

• Windows 11

  • Hou 21.0.512
  • Hou 20.5.370
  • Hou 20.5.332
  • Hou 20.0.705
  • Hou 20.0.688
  • Hou 19.5.805
  • Hou 19.5.976
  • Maya 2026 (UsdAddon_0.25.5)
  • Maya 2025
  • Maya 2024

Run build using python script

Run build (Houdini):

python build_resolver.py --dcc houdini --dcc-root <houdini/installation/path> --clean --zip

Run build (Maya):

python build_resolver.py --dcc maya --dcc-root <maya/installation/path> --maya-devkit <maya/devkit/path> --maya-usd-root <maya/usd/root/path> --jobs 4 --clean

or see the help:

python build_resolver.py --help

Run build using cmake only

Run build (Houdini):

cmake -S . -B <build/dir/path> -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=<install/dir/path> -DBUILD_TARGET=houdini -DUSE_OPENSSL3=OFF -DUSD_ROOT=<houdini/root/dir> -DCMAKE_PREFIX_PATH=<houdini/cmake/path> -DPYTHON_EXECUTABLE=<houdini/python/path>

cmake --build <build/dir/path> --target install -j 4

Run build (Maya):

cmake -S . -B "/build/dir/path" -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=<install/dir/path> -DBUILD_TARGET=maya -DUSE_OPENSSL3=ON -DMAYA_ROOT=<maya/root/path> -DMAYA_USD_DEVKIT_PATH=<maya/devkit/path> -DUSD_ROOT=<maya/usd/path> -DPYTHON_EXECUTABLE=<maya/python/path>

cmake --build <build/dir/path> --target install -j 4

Download the repo and its submodules:

```
git clone --recurse-submodules https://github.com/ynput/ayon-usd-resolver.git

git submodule update --init --recursive
```

DoxyGen Docs

Can be found on the connected GH Page Docs GH Page

Pre-build / Self Compiled

• AYON provides some pre-built versions of the Resolver at https://lake.ayon.cloud. Access credentials can be provided upon request.

• Those versions are the pre-built binaries that our tests created, so you might not find your software/platform combination.

• It's also to be expected that resolver builds are behind new software releases.

Prebuild

• Prebuilts aren't available as of right now.

Self Compiled

• See Doxygen Docs Getting Started Page