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

Metadata

Release files for omniverse-kit 109.0.7.347000

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for omniverse-kit 109.0.7.347000
File Size Uploaded
omniverse_kit-109.0.7.347000.tar.gz 2.0 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for omniverse-kit 109.0.7.347000
File Interpreter ABI Platform
omniverse_kit-109.0.7.347000-cp312-none-win_amd64.whl CPython 3.12 none Windows x86-64 Details
omniverse_kit-109.0.7.347000-cp312-none-manylinux_2_35_x86_64.whl CPython 3.12 none Linux glibc 2.35+ x86-64 Details

Total release size: 76.8 MB

Release files / omniverse_kit-109.0.7.347000.tar.gz

Download URL omniverse_kit-109.0.7.347000.tar.gz
Size 2.0 kB
Tags Source
SHA-256 checksum
How to use checksums
fb3d792d59f4e70b920fbf2402137b085788152070f44e4336fd31a0dd5f447a
BLAKE2b-256 checksum
How to use checksums
bdcb2c7568739d284a0c14f791895b270e1ff0db8bd80e22aa25c133b8d4489c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Release files / omniverse_kit-109.0.7.347000-cp312-none-win_amd64.whl

Download URL omniverse_kit-109.0.7.347000-cp312-none-win_amd64.whl
Size 76.7 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
d6327f2977e9b78c7d2e8c3bcd771dace30f034da55b6e543c8723b8c7bb9ce9
BLAKE2b-256 checksum
How to use checksums
fbe068874658cc77278b90889b03054bec6f917b1430449d7b2af51935aede46
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Release files / omniverse_kit-109.0.7.347000-cp312-none-manylinux_2_35_x86_64.whl

Download URL omniverse_kit-109.0.7.347000-cp312-none-manylinux_2_35_x86_64.whl
Size 57.3 kB
Tags CPython 3.12 Linux glibc 2.35+ x86-64
SHA-256 checksum
How to use checksums
3098121058492b9f0d1a90277a27b87770275d175048a709d533b7b5a037a4e6
BLAKE2b-256 checksum
How to use checksums
2012ae63ed501a21ec4b5e36364cdfada98460b2e9b6d2bc9e94259fc2bf48a9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.6

Release history Release notifications | RSS feed

This release

109.0.7.347000 This release

3 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page