Avatar Configurator#

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:
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.
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#
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.
Usage Instructions#
The steps below show how to customize an avatar with the Avatar Configurator:

Avatar Configurator application window
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).
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.
Click on Save Screenshot (see D) to save a screenshot of the current viewport to the /screenshots directory.
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.
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.
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:
The right zip for the installed OS was downloaded (Windows/Linux).
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.
Minimum hardware requirements are met, if specified.
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 orC:\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 formatx.x
.
Licenses#
Omniverse Kit 106.5.3
---------------------
https://docs.omniverse.nvidia.com/dev-guide/latest/common/legal.html