DeepSearch Beta Usage


DeepSearch is a set of services that allow Omniverse users to search 3D models and images stored within an Enterprise Nucleus Server using common and natural language, as well as images.

The following instructions explain how to use new DeepSearch Beta interface. To use this Beta interface, your DeepSearch server must be running version 2023.1.0 or later which is currently available to Early Access/Pre-Release customers only. If you are not part of the Early Access/Pre-Release Program, click here to apply.


You must be connected to a DeepSearch enabled Enterprise Nucleus Server to use these features. If you are unsure if DeepSearch is enabled within your environment, please contact your systems administrator.

Using DeepSearch Beta

The DeepSearch Beta interface is currently only available in Omniverse Kit-based Aps, such as USD Composer. Note that in USD Composer, the required extensions must be installed and enabled first.

Using DeepSearch Beta in USD Composer

Enable the DeepSearch Beta extensions

In enable access to the DeepSearch Beta interface, follow the steps below:

  1. Within USD Composer, click Window, then Extensions.

  2. Click the gear icon (settings) next to the search field, which will open the list of registries that USD Composer is connected to:

    DeepSearch (Beta) Extension Registries Gear button
  3. In the Extension Registries section, add the Kit public registry by clicking the plus icon, then enter the following information as shown below:

    • name: kit/public/104.2

    • url:

    DeepSearch (Beta) Extension Registries Gear button

    This will enable the additional registry where to find the required extensions.

  4. Within the search field, erase the default text and type ngsearch.

  5. Within the general dropdown, install the latest omni.kit.ngsearch extension, make sure it’s enabled, and the Autoload checkbox is checked. - The installed version must be 0.1.1 or greater.

DeepSearch (Beta) Extension Manager
  1. After the omni.kit.ngsearch extension is installed, the remaining Deepsearch extensions must be installed and enabled.

  2. Within the search field, erase the previously typed text and type deepsearch.

  3. Within the general dropdown, install the following three extensions, make sure they are enabled, and the Autoload checkbox is checked.

    • omni.kit.deepsearch.visualization - The installed version must be 0.3.7 or greater.

    • omni.kit.browser.deepsearch - The installed version must be 1.0.30 or greater.

    • omni.kit.browser.deepsearch_embedding - The installed version must be 0.3.5 or greater.


The omni.kit.browser.deepsearch_embedding extension depends on the other two, so it must be installed and enabled after the other two extensions are installed and enabled. Enabling it before the other extensions will display a dependency resolution error.

DeepSearch (Beta) Extension Manager
  1. After all the required extensions are installed, close the Extensions window.

  2. Click Window on the top toolbar again and select DeepSearch (Beta) to activate the extension. The DeepSearch Beta tab will appear.

DeepSearch (Beta) Tab

You can engage DeepSearch in two different ways:

Image as a search query

You also can search for an asset with an image. To do this, drag an image from your computer into the DeepSearch dropzone. Dropping an image will automatically engage DeepSearch. If results are found, they will appear.

Search query customization

In order to narrow down the search to a subset of asset types the following Quick Filters can also be applied:




Displays all returned results (no filtering)


Filters and displays only USD models


Filters and displays images in common formats (.jpg, .png, etc.)


Filters and displays materials (MDL format, etc.)


Enter in the file extension within the custom field you wish to filter on

To further customize the query it is possible to use the search options menu, which allows to add more filters to the query (e.g., creation date, file size, tags, file name, etc.)

DeepSearch (Beta) Search options

There is also a possibility to control the number of search results returned by the server using the Max. samples parameter:

DeepSearch (Beta) Search options max samples

By default, this parameter is set to 64 not to overload the backend search engine, however this value can be changed as needed.


The greater the number of requested search results, the longer it may take the DeepSearch server to process the search and return results.

It is also possible to customize the query using a dedicated query language. Please refer to Query Syntax for more information.

Additional functionality

If an image that’s not exactly what you were looking for is returned, you can right-click it and choose Find Similar from the menu that appears. This may help narrowing down the search and showing you the perfect asset or image for your project.

DeepSearch Find Similar

Once you have found the perfect asset or image, simply drag and drop it directly into the viewport to add it to your scene.

DeepSearch Drag and Drop

User Interface Tips & Tricks

To make the DeepSearch interface easier to navigate and use, review these helpful tips:

  • Once a search is performed, the mouse wheel can be used to zoom in and zoom out of the results. Additionally, clicking (and holding) the magnifying glass icon with your left mouse button in the viewport while moving your mouse will also zoom in and out of the results.

  • To pan through the search results, hold the right mouse button while moving the mouse. Additionally, clicking (and holding) the hand icon with your left mouse button in the viewport while moving your mouse will also pan through the results.