Metadata-Version: 2.4
Name: warp-optix
Version: 0.3.0
Summary: Warp ray tracing with PyOptiX
Keywords: optix,ray-tracing,nvidia,cuda,gpu,rendering
Author: NVIDIA Corporation
License-Expression: Apache-2.0 AND BSD-3-Clause AND LicenseRef-NVIDIA-OptiX
License-File: LICENSE.md
License-File: LICENSE.txt
License-File: OptiX_LICENSE.txt
License-File: THIRD_PARTY_NOTICES.txt
License-File: licenses/nvpro_core-NOTICE.txt
License-File: licenses/pybind11-LICENSE.txt
License-File: licenses/vk_denoise_dlssrr-NOTICE.txt
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: C++
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Project-URL: Homepage, https://github.com/NVIDIA/warp-optix
Project-URL: Documentation, https://github.com/NVIDIA/warp-optix#readme
Project-URL: Repository, https://github.com/NVIDIA/warp-optix
Project-URL: Issues, https://github.com/NVIDIA/warp-optix/issues
Requires-Python: <3.13,>=3.12
Requires-Dist: pyoptix==9.1.1
Requires-Dist: warp-lang>=1.17
Requires-Dist: numpy>=1.20
Provides-Extra: training
Requires-Dist: warp-nn>=0.3.1; extra == "training"
Provides-Extra: pathtracing
Requires-Dist: imageio>=2.31; extra == "pathtracing"
Requires-Dist: Pillow>=9; extra == "pathtracing"
Requires-Dist: pyglet<3,>=2.1; extra == "pathtracing"
Provides-Extra: usd
Requires-Dist: usd-core<26.5,>=25.5; platform_machine != "aarch64" and python_version < "3.14" and extra == "usd"
Requires-Dist: usd-exchange>=2.2.0; platform_machine == "aarch64" and python_version < "3.13" and extra == "usd"
Provides-Extra: ui
Requires-Dist: imgui-bundle>=1.92; extra == "ui"
Requires-Dist: PyOpenGL>=3.1; extra == "ui"
Description-Content-Type: text/markdown

# Warp-OptiX: Ray Tracing with NVIDIA Warp

[Documentation](https://github.com/NVIDIA/warp-optix#readme) |
[Examples](https://github.com/NVIDIA/warp-optix/blob/main/examples/README.md)

Warp-OptiX brings NVIDIA OptiX ray tracing to Warp. Write ray-generation, hit,
miss, and callable programs as Warp kernels, or use the included path tracer.
The Python API provides managed contexts, acceleration structures, automatic
shader binding tables, and launches that mirror `wp.launch`.

## Installation

```bash
pip install warp-optix
```

GPU execution requires a compatible NVIDIA GPU and driver; no CUDA Toolkit or
OptiX SDK is needed. Wheels support Python 3.12 on Linux x86-64 and Windows x64.
Source builds require Python 3.12 and a C++17 compiler. See the
[installation guide](https://github.com/NVIDIA/warp-optix/blob/main/README.md#installation)
for source and development setup.

PyOptiX 9.1.1 is installed automatically. The package includes OptiX SDK 9.1.0
headers for runtime kernel compilation, so a separate OptiX SDK installation
is not required.

Optional extras add path tracing, UI, USD loading, and neural-network training:

```bash
pip install "warp-optix[pathtracing,ui,usd]"
pip install "warp-optix[training]"
```

## Getting started

```python
import warp as wp
import warp_optix as wo
from warp_optix.pathtracing import PathTracer
```

Follow the [API overview](https://github.com/NVIDIA/warp-optix#api)
to build a custom ray tracer, or explore the
[runnable examples](https://github.com/NVIDIA/warp-optix/blob/main/examples/README.md).
Advanced applications can access PyOptiX and supplemental bindings through
`warp_optix.native`.

**CUDA graph capture is currently unsupported for OptiX operations.** Submit
OptiX work between captured Warp graphs on the same stream; CUDA stream
ordering is supported.

## Support and contributions

Report bugs and feature requests through
[GitHub Issues](https://github.com/NVIDIA/warp-optix/issues).
The project is currently not accepting outside contributions; see the
[contribution policy](https://github.com/NVIDIA/warp-optix/blob/main/CONTRIBUTING.md)
for updates. Report security vulnerabilities privately using the
[security policy](https://github.com/NVIDIA/warp-optix/blob/main/SECURITY.md).

## License

Warp integration uses [Apache-2.0](https://github.com/NVIDIA/warp-optix/blob/main/LICENSE.md);
supplemental bindings use [BSD-3-Clause](https://github.com/NVIDIA/warp-optix/blob/main/LICENSE.txt).
Bundled OptiX headers retain their
[NVIDIA SDK terms](https://github.com/NVIDIA/warp-optix/blob/main/OptiX_LICENSE.txt).
See [third-party notices](https://github.com/NVIDIA/warp-optix/blob/main/THIRD_PARTY_NOTICES.txt)
for component licenses and source provenance. License texts accompany the distribution.
