Skip to main content

(kit-python-package-main-doc)=

Kit Python Package

Kit is published as a Python (PIP, wheel) package. This means that you can use Kit as a Python library in your Python projects.

It can be found PyPI index. But it is a placeholder package, to install Kit from PyPI you need pass an extra index URL to pip:

pip install omniverse-kit --extra-index-url https://pypi.nvidia.com

Getting Started

python -m venv myenv
myenv\Scripts\activate
pip install omniverse-kit --extra-index-url https://pypi.nvidia.com
python -m omni.kit_app

In this example we create a new virtual environment, activate it, install Kit into it as python package, and run Kit. It will start in the same way as if it was started from the kit.exe, but instead your python is used.

KitApp Example

The omni.kit_app module provides an initial bootstrapping and KitApp class, which is a Pythonic way to start Kit. It is a thin wrapper around the kit.exe command line interface, and it provides a way to start Kit from Python, to pass command line arguments to it, to control the basic update loop:

:language: py

In this example we startup Kit asking it to enable omni.ui extension. Use it to build a simple UI window. After that we keep app update loop running until app is signaled to exit. That will only work if among enabled extension is omni.kit.loop (or similar) which implements the main update loop interface (omni::kit::IRunLoopRunner). Otherwise Kit will exit.

The from omni.kit_app import KitApp import must be the first of omniverse imports, it sets up the environment (loads Carbonite, adds library and python paths).

Typically extensions subscribe to update loop events (like render UI every frame, process new input events, etc). However, for some applications it might be useful to have a full control over the update loop. To call explicit API of various extensions, rather than rely on their event-based API:

:language: py

In this example we startup Kit asking it to enable omni.usd extension. After that extension is available (added to sys.path, startup was called) and we can use it in our Python code.

EULA

On the first import of omni.kit_app module, it will ask you to accept the EULA. This is a one-time operation, if accepted, it will not ask again. An alternative way to accept the EULA is to set the environment variable OMNI_KIT_ACCEPT_EULA to yes.

Editable Mode

You can install Kit python package in editable mode, which means that you can modify the source code and see the changes immediately. This is useful for development and debugging.

Assuming you've built Kit from source:

pip install -e [path to kit source]/_build/packages/python/omniverse-kit

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

omniverse_kit-110.1.3.349534-cp312-none-win_amd64.whl (64.8 MB view details)

Uploaded CPython 3.12Windows x86-64

omniverse_kit-110.1.3.349534-cp312-none-manylinux_2_35_x86_64.whl (74.2 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.35+ x86-64

omniverse_kit-110.1.3.349534-cp312-none-manylinux_2_35_aarch64.whl (82.5 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.35+ ARM64

File details

Details for the file omniverse_kit-110.1.3.349534-cp312-none-win_amd64.whl.

File metadata

File hashes

Hashes for omniverse_kit-110.1.3.349534-cp312-none-win_amd64.whl
Algorithm Hash digest
SHA256 4a76724edaace54512298be7166767d8c3e4ea60f86ae4fc865479f28ac2e82d
MD5 0f87ac85f645b260279bbe4b684830cc
BLAKE2b-256 d8fcb6af6671427d7b0f1ece9d872e7676b5f3a199daeb7e252e7c0f5fa8bb04

See more details on using hashes here.

File details

Details for the file omniverse_kit-110.1.3.349534-cp312-none-manylinux_2_35_x86_64.whl.

File metadata

File hashes

Hashes for omniverse_kit-110.1.3.349534-cp312-none-manylinux_2_35_x86_64.whl
Algorithm Hash digest
SHA256 8a2f59fe07f75288ff68e4dafb406d7483ad09e5d8e034e15d354f893ca2a602
MD5 3d792de0afdc946e596c7e558c03cb4d
BLAKE2b-256 e16a7345db8433b372ce47b2c5557f59cc77b7ac0132c705877baa15839c3de5

See more details on using hashes here.

File details

Details for the file omniverse_kit-110.1.3.349534-cp312-none-manylinux_2_35_aarch64.whl.

File metadata

File hashes

Hashes for omniverse_kit-110.1.3.349534-cp312-none-manylinux_2_35_aarch64.whl
Algorithm Hash digest
SHA256 d1cc8d48bbf031dc04f40b114e2be0ec412ff9c556eeb9756883034d5ddc3ab0
MD5 d08aa909d569cd5d540c7d956dc7be12
BLAKE2b-256 627881a57d60cd5a2a2bd874ebff4b4629dc0b36d4666390adcdd9a8ff0c44f2

See more details on using hashes here.

Release history Release notifications | RSS feed

110.2.0.342835

3 files

This release

110.1.3.349534 This release

3 files

110.1.1.305458

2 files

110.1.0.293547

1 file

110.0.0.276876

1 file

109.0.7.347000

3 files

109.0.5.296990

1 file

109.0.4.281012

1 file

109.0.3.263267

1 file

109.0.2.256998

1 file

109.0.1.252186

1 file

109.0.0.247772

1 file

108.1.0.234166

1 file

108.0.0.221586

1 file

108.0.0.220354

1 file

107.3.7.285824

1 file

107.3.6.275734

1 file

107.3.5.259650

1 file

107.3.1.206797

1 file

107.3.0.199947

1 file

107.2.0.190954

1 file

107.2.0.189680

1 file

107.0.3.180676

1 file

106.5.0.162521

1 file

106.4.0.156974

1 file

106.3.0.150500

1 file

106.2.0.146576

1 file

106.1.0.140981

1 file

106.0.3.138428

1 file

106.0.2.127937

1 file

106.0.1.126909

1 file

106.0.0

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page