Avatar Configurator#

The Avatar Configurator application

The Avatar Configurator application#

The Avatar Configurator offers a simple workflow to customize the look & feel of the ACE avatar. It includes choosing a base avatar, changing accent colors, and placing a logo on the shirt, among other customization options.

Go to the page Custom Avatar instead if you would like to import a custom avatar created with a digital content creation tool (e.g. Blender) or a third-party character creator.

Prerequisites#

The Avatar Configurator is a local application running on your desktop or laptop. Before running the Avatar Configurator, make sure your system satisfies the following minimum system requirements:

  • Windows or Linux operating system

  • GPU: RTX GPU. Make sure that the system can find the RTX GPU, e.g. by listing it as a result when running nvidia-smi on Linux.

  • Storage: 5GB

  • Current driver: https://developer.nvidia.com/omniverse/driver

Ideally your system also satisfies the following requirement for the best experience:

  • CPU Cores: 4

  • RAM: 16GB

  • VRAM: 8GB

Known working system configurations:

  • Ubuntu 20.04.5, NVIDIA RTX A6000, Driver Version: 515.65.01

  • Windows 10 Pro, NVIDIA RTX A3000 Laptop GPU, Driver Version: 472.12

Versions#

The Avatar Configurator is based on Kit version 105.1+release.132758.65e0bc6b.

Installation#

Follow the steps below to download and run the Avatar Configurator:

  1. Download the Avatar Configurator files from NGC here:

    Note

    The download through NGC will take a while (3-6 min). After the download is completed, you will get a message with the status: “Completed” and the folder where the zip file is located.

  2. Unzip to a local folder. Notice that for Windows you have to unzip it to a short path (e.g. C://configurator/)or you will be prompted with an error message.

Now, you have all the files to run the Avatar Configurator.

Setup & Run#

  1. To start up the Avatar Configurator, navigate to the unpacked directory and run from the command line:

    • For Windows:

      .\run_avatar_configurator.bat
      
    • For Linux:

      ./run_avatar_configurator.sh
      

    Note

    When you start the app for the first time on a new PC, it will take up to 15 minutes until the complete scene including the avatar appears. Once the avatar shows up you are ready to use the app. During the first run, make sure to leave the app running until the initialization message disappears and the avatar appears.

    • On Windows a message saying Windows protected your PC might appear. Click “More Info” and “Run anyway” to continue.

      Windows protect

Usage Instructions#

The steps below show how to customize an avatar with the Avatar Configurator:

Avatar Configurator application

Avatar Configurator application window

  1. Edit the various properties shown in the Properties panel (see B) until you are happy with the result. You can see the resulting avatar changing in the viewport (see C).

  2. The avatar animations can be played or paused with the button Play/Pause in the bottom right corner. Having the animations paused (the default behavior) will increase performance in case the avatar is lagging. Play animations to see the avatar moving.

  3. Click on Save Screenshot (see D) to save a screenshot of the current viewport to the /screenshots directory.

  4. Click on “Save Scene” (see E) to export a directory containing the USD scene file and other related assets to the /exported directory.

    Note

    The folders only appear after you exported your first scene or screenshot.

    Exported scene directory
  5. The scene in the /exported directory is ready to be used with the Omniverse Renderer microservice. If you are running the Docker container locally as described in Run Container Locally you can point the asset path to the exported scene, or when you are running the Omniverse Renderer in Kubernetes, you can upload the entire /exported directory to NGC with a method described in Resource Downloader.

    Note

    Go to the Custom Avatar section instead, if you would like to import a custom generated scene and avatar.

Usage Outside of the ACE Animation Pipeline#

The scenes exported from the Avatar Configurator are optimized to work in the ACE animation pipeline. Other use cases are currently not supported, and the scenes might not work properly with other Omniverse tools.

Performance Overview#

This table provides a rough indication of the GPU utilization that can be expected from various scene, parameter, and GPU combinations.

Note

These measurements have not been made with the latest scene and Kit versions and the measurements might be off. They should nevertheless still give you an approximate idea of what GPU utilization to expect from what scene.

GPU utilization and frame rate overview for scenes created with the avatar configurator#

Scene

Avatar

GPU

Resolution

FPS

GPU Usage

Image Background

Violet

A10

720p

30

38%

Image Background (mood2)

Violet

A10

720p

30

38%

QSR

Violet

A10

720p

30

56%

QSR (mood2)

Violet

A10

720p

30

62%

Data Center

Violet

A10

720p

30

54%

Data Center (mood2)

Violet

A10

720p

30

54%

Desk

Violet

A10

720p

30

62%

Desk (mood2)

Violet

A10

720p

30

50%

Skyscraper

Violet

A10

720p

30

51%

Skyscraper (mood2)

Violet

A10

720p

30

50%

Store

Violet

A10

720p

30

71%

Store (mood2)

Violet

A10

720p

30

62%

Image Background

Violet

A10

1080p

30

56%

Image Background (mood2)

Violet

A10

1080p

30

57%

QSR

Violet

A10

1080p

30

85%

QSR (mood2)

Violet

A10

1080p

28

100%

Data Center

Violet

A10

1080p

30

80%

Data Center (mood2)

Violet

A10

1080p

30

77%

Desk

Violet

A10

1080p

29

100%

Desk (mood2)

Violet

A10

1080p

30

76%

Skyscraper

Violet

A10

1080p

30

75%

Skyscraper (mood2)

Violet

A10

1080p

30

74%

Store

Violet

A10

1080p

28

100%

Store (mood2)

Violet

A10

1080p

29

92%

Image Background

Violet

T4

720p

30

67%

Image Background (mood2)

Violet

T4

720p

30

67%

QSR

Violet

T4

720p

29

100%

QSR (mood2)

Violet

T4

720p

24

100%

Data Center

Violet

T4

720p

29

96%

Data Center (mood2)

Violet

T4

720p

29

100%

Desk

Violet

T4

720p

22

100%

Desk (mood2)

Violet

T4

720p

30

95%

Skyscraper

Violet

T4

720p

29

96%

Skyscraper (mood2)

Violet

T4

720p

30

92%

Store

Violet

T4

720p

22

100%

Store (mood2)

Violet

T4

720p

22

100%

Image Background

Violet

T4

1080p

24

100%

Image Background (mood2)

Violet

T4

1080p

24

100%

QSR

Violet

T4

1080p

15

100%

QSR (mood2)

Violet

T4

1080p

13

100%

Data Center

Violet

T4

1080p

17

100%

Data Center (mood2)

Violet

T4

1080p

16

100%

Desk

Violet

T4

1080p

12

100%

Desk (mood2)

Violet

T4

1080p

18

100%

Skyscraper

Violet

T4

1080p

17

100%

Skyscraper (mood2)

Violet

T4

1080p

18

100%

Store

Violet

T4

1080p

12

100%

Store (mood2)

Violet

T4

1080p

12

100%

Troubleshooting and Logging#

Before filing a bug, make sure to check the following steps:

  1. The right zip for the installed OS was downloaded (Windows/Linux).

  2. The unzipping process of the Avatar Configurator worked without crashing (e.g. there was no message regarding long paths). Notice that unpacking can take a long time.

  3. Minimum hardware requirements are met, if specified.

  4. When filing a bug, given that the steps above are checked, please attach the latest log file found at /home/<username>/.nvidia-omniverse/logs/Kit/omni.avatarstudio.app/<version> log file path for Linux or C:\Users\<username>\.nvidia-omniverse\logs\Kit\omni.avatarstudio.app\<version> log file path for Windows where <username> is the username with which you have logged in to Windows or Linux and <version> is the current version of the Avatar Configurator and usually has the format x.x.

Licenses#

Omniverse Kit 106.5.3
---------------------

https://docs.omniverse.nvidia.com/dev-guide/latest/common/legal.html