Asset Uploader

Upload Metahumans, Reallusion characters, and scenes from Unreal Engine to Convai Sim and Avatar Studio using the Convai Asset Uploader tool.

The Convai Asset Uploader uploads Metahumans, Reallusion characters, and scenes from Unreal Engine directly to Avatar Studio and Convai Sim. The tool automates project creation, plugin integration, and asset packaging through a command-line interface. Use this page to install the tool, run it against an Unreal Engine 5.8 project, and upload your first asset.

The Asset Uploader is available only on the Professional Plan and above.

Prerequisites

Before running the Asset Uploader, confirm the following:

Unreal Engine 5.8
A Convai API key from the Convai Dashboard
.NET 6.0 Runtime (Console Applications) — download the .NET 6.0 console runtime
The Unreal Engine 5.8 cross-compile toolchain requirements, including the toolchain version history
The Linux binaries for Unreal Engine 5.8, available from the Epic Games Launcher

Download and run the tool

Download the Asset Uploader

Download the latest AssetUploaderTool.exe from the Convai Asset Uploader GitHub Releases. Move the file to the directory where you want your new Unreal Engine project to be created — the tool creates and configures the Convai Unreal Engine project automatically.

Run the uploader tool

Double-click AssetUploaderTool.exe to run it. If Windows shows a "Windows protected your PC" screen, select More info > Run anyway. The tool is safe to run — the warning appears because the tool is currently in beta and not digitally signed.

Follow the prompts

The tool opens in a terminal window and walks through:

Unreal Engine path detection — confirm a message such as Found Valid Unreal Engine Path: C:/Program Files/Epic Games/UE_5.8. Enter Y to confirm the path or N to provide a different path.
Project configuration — enter the project name and your Convai API key.
Asset type selection — press 1 to upload a scene or 2 to upload an avatar.
Avatar type selection (avatars only) — respond to Are you using a Metahuman for your Avatar? with Y for a MetaHuman setup or N for a Reallusion setup.

Verify the upload

Once configuration is complete, the tool generates a new Unreal Engine project, installs and configures the Convai plugins, and begins compiling the project. The upload is complete once the terminal shows:

Unreal Compilation completed successfully

Press Enter to exit.

The new project is created in the same directory as AssetUploaderTool.exe. For example, if the tool is placed in Downloads, the project is generated inside Downloads.