| name | setup-environment |
| description | Use when setting up a fresh clone of this repo to run OVRTX Dev Variant Presenter (also called the "variant studio" in the walkthrough video and earlier releases) — no .venv yet, ovrtx/ovstage/ovstream not installed, ModuleNotFoundError on ovrtx/ovstage/ovstream, or "how do I install / get this running". RTX + uv; validated on Windows. |
Set up the environment to run OVRTX Dev Variant Presenter
The environment is NOT shipped — .venv is gitignored. uv sync rebuilds it from pyproject.toml.
Prerequisites (README §Requirements)
- An NVIDIA RTX GPU + recent driver. Rendering is headless via Vulkan; no display server needed. This app does not run without an RTX GPU. Developed and validated on Windows 11; Linux is supported by the stack (all three packages ship manylinux wheels) but is not routinely validated here.
- Python 3.11, via
uv. uv must already be installed (it is NOT auto-installed here).
- A modern Chromium browser (Chrome / Edge) for the viewer.
- A USD stage to open — none is bundled; the public NVIDIA ConceptCar URL in the README is the quickest one to try.
Install
From the repo root:
uv sync
This creates .venv and installs everything — including ovrtx (renderer), ovstage
(live stage host), and ovstream (WebRTC streamer) — from PyPI; uv.lock pins the
validated versions (ovrtx 0.4.x, ovstage 0.1.x, ovstream 0.4.x, Python 3.11). No
extra index, flag, or auth needs to be configured — but the install : the package on PyPI is only a sdist
whose build backend downloads the real platform wheel from NVIDIA's index, so an environment
restricted to alone cannot complete . ( /
also run this automatically on first launch if is missing.)
