Skip to main content

LibreDR is an open-source ray-tracing differentiable renderer

[Codeberg Repo] [API Document]

LibreDR uses client-server-worker structure to better utilize multiple GPUs (or even multiple nodes on a cluster).
Some code examples are under the examples/ directory.

To run server and worker under Linux:

  1. Download libredr_linux_*.tar.gz under [releases].
  2. Start server and worker using examples/scripts/{server,worker}.sh or with your own configuration.
    Example configurations are in examples/scripts. Use clinfo to verify OpenCL runtime.

To run a server and worker under Windows:

  1. Download libredr_windows_*.zip under [releases].
  2. Start server and worker using examples/scripts/{server,worker}.bat or with your own configuration.
    Example configurations are in examples/scripts.

To run the example Python codes or your own Python code

  1. Download libredr-*.whl under [releases] and install using pip install, or install from [PyPI].
  2. Run Python example codes examples/scripts/run_example.{sh,bat} or your own client codes.

All the examples are tested on the following platforms:

Version OS Device Driver Note
🟢v0.0.21 Debian Bookworm Linux 6.7.12+bpo-amd64 CPU: Intel Core i7-8550U PoCL v3.1 Tested on both opencl_program = source and spirv64
🟢v0.0.21 Debian Bullseye Linux 6.7.12+bpo-amd64 GPU: Hygon DCU Z100L Hygon Proprietary v25.04 Tested on opencl_program = source
🟢v0.0.21 Debian Bullseye Linux 6.7.12+bpo-amd64 GPU: NVIDIA GeForce RTX 3090 NVIDIA Proprietary v535.216.01 Tested on opencl_program = source
🟢v0.0.21 Debian Bullseye Linux 6.7.12+bpo-amd64 GPU: AMD Radeon RX 6700 XT AMD ROCm AOMP v19.0-3 Tested on opencl_program = source
🟢v0.0.21 Debian Bullseye Linux 6.7.12+bpo-amd64 GPU: Intel UHD Graphics 620 Intel NEO v22.43.24595.41 Tested on opencl_program = spir64 and spirv64
🟢v0.0.21 Ubuntu 18.04.2 LTS Linux 4.4.179 GPU: ARM Mali-T860 ARM Proprietary v1.r14p0-01rel0-git Tested on opencl_program = source
🟢v0.0.20 Windows 10 21H2 (OS Build 19044.5608) GPU: AMD Radeon RX 6700 XT AMD Proprietary v24.12.1 Unix socket and spir* are not available
🟢v0.0.20 Windows 10 21H2 (OS Build 19044.5608) GPU: Moore Threads MTT S80 Moore Threads Proprietary v290.100.1 Tested on OpenCLOn12 v1.2404.1.0 ⚠️ with performance issue

To build from source codes for Linux, check the build scripts in examples/scripts_unix/build/. Docker is used to build manylinux-compatible wheels. For Windows, check examples/scripts_windows/build/.

Copyright (c) 2022-2025 Bohan Yu. All rights reserved.
LibreDR is free software licensed under the GNU Affero General Public License, version 3 or any later version.

Metadata

Release files for libredr 0.0.22

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

Source distribution (sdist)

Source distribution for libredr 0.0.22
File Size Uploaded Provenance
libredr-0.0.22.tar.gz 71.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for libredr 0.0.22
File Interpreter ABI Platform
libredr-0.0.22-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.8 abi3 Linux glibc 2.17+ x86-64 Details

Total release size: 1.2 MB

Release files / libredr-0.0.22.tar.gz

Download URL libredr-0.0.22.tar.gz
Size 71.9 kB
Tags Source
SHA-256 checksum
How to use checksums
09cd24ae35d761d90913b2539b81015ffc91c2e9e6a7e611a184322a5ef0c73d
BLAKE2b-256 checksum
How to use checksums
6ffa5ebb375dfc7eb6a89c7884f42493ace13373f9b35be64e87fe024f23f748
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.10.2

Release files / libredr-0.0.22-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL libredr-0.0.22-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 1.1 MB
Tags CPython 3.8 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
80ab204c520a93a4470c3a3f8eef13bde2216e597b8215a832580e5053f8bb3e
BLAKE2b-256 checksum
How to use checksums
9f540af704cd7ea8deaa9c92eb3d539f4811293b065039b5c9a10b1d96a8d26c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via maturin/1.10.2

Security for libredr 0.0.22

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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