Pre-release

This release is a pre-release and may not be stable for production use.

lightusd

Lightweight, dependency-free USD (Universal Scene Description) library for Python: load and author USDA / USDC / USDZ, resolve composition, and extract GPU-ready render data — with zero-copy NumPy interop.

Built on the LightUSD next core + tydra-next (no pxrUSD install required, no legacy core in the wheel; native cmake -S . and WASM still provide the legacy path via web/binding.cc). v1.0.0, npm preview dist-tag. Wheels:

  • cp310-abi3 — one stable-ABI wheel covers CPython 3.10+
  • cp314t — native free-threaded (GIL-less) CPython 3.14 wheel
pip install lightusd

Reading

import numpy as np
import lightusd

stage = lightusd.load("scene.usdz")          # usda / usdc / usdz, composed
for prim in stage:                            # depth-first traversal
    print(prim.path, prim.type_name)

mesh = stage.prim_at("/World/Mesh")
points = np.asarray(mesh["points"])           # zero-copy (N, 3) float32
attr = mesh.attribute("xformOp:translate")
if attr.has_timesamples:
    value = attr.get(time=12.0)               # linear interpolation
print(mesh.relationship("material:binding").targets)

Authoring

st = lightusd.Stage.create()
st.up_axis = "Y"
grid = st.define_prim("/World/Grid", "Mesh")
grid.set("points", np.zeros((64, 3), np.float32), type="point3f[]")
grid.set("purpose", "render", uniform=True)
grid.set("xformOp:translate", (0.0, 1.0, 0.0), time=0.0)
st.set_default_prim("World")
st.save("out.usdc")                           # or .usda / .usdz

Render extraction (tydra)

from lightusd import tydra

scene = tydra.to_render_scene(stage)          # triangulated, GPU-friendly
for mesh in scene.meshes:
    vertices = np.asarray(mesh.points)                # (N, 3) float32
    indices = np.asarray(mesh.triangulated_indices)   # (T,) uint32
    material = scene.materials[mesh.material_id]
    base_color = material.param("diffuse_color")      # tuple or RenderTexture

Notes

  • NumPy is optional (interop only, not a dependency).
  • lightusd.flatten_file(src, dst) runs a low-memory compose+flatten pipeline that streams large arrays through without decoding them.
  • Free-threaded CPython: concurrent reads of one Stage are safe; do not author to a stage while other threads read it.

Apache 2.0. Part of LightUSD.

Project links

Data verified by PyPI on Sep 3, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for lighttransport from gravatar.com lighttransport

Credits

Author: Syoyo Fujita

GitHub Statistics

Data verified by PyPI on Sep 3, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache 2.0 License )

Requires

Python >=3.10

Provides Extra

test

Tags

usd usda usdc usdz pixar 3d scene

Classifiers

Report project as malware

Download files

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

Source Distribution

lightusd-1.0.0rc4.tar.gz (5.4 MB view details)

Uploaded Source

Built Distributions

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

lightusd-1.0.0rc4-cp314-cp314t-win_arm64.whl (973.2 kB view details)

Uploaded CPython 3.14tWindows ARM64

lightusd-1.0.0rc4-cp314-cp314t-win_amd64.whl (1.1 MB view details)

Uploaded CPython 3.14tWindows x86-64

lightusd-1.0.0rc4-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.3 MB view details)

Uploaded CPython 3.14tmanylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

lightusd-1.0.0rc4-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl (1.2 MB view details)

Uploaded CPython 3.14tmanylinux: glibc 2.27+ ARM64manylinux: glibc 2.28+ ARM64

lightusd-1.0.0rc4-cp314-cp314t-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded CPython 3.14tmacOS 11.0+ ARM64

lightusd-1.0.0rc4-cp310-abi3-win_arm64.whl (939.5 kB view details)

Uploaded CPython 3.10+Windows ARM64

lightusd-1.0.0rc4-cp310-abi3-win_amd64.whl (1.1 MB view details)

Uploaded CPython 3.10+Windows x86-64

lightusd-1.0.0rc4-cp310-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (1.3 MB view details)

Uploaded CPython 3.10+manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

lightusd-1.0.0rc4-cp310-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl (1.2 MB view details)

Uploaded CPython 3.10+manylinux: glibc 2.27+ ARM64manylinux: glibc 2.28+ ARM64

lightusd-1.0.0rc4-cp310-abi3-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

File details

Details for the file lightusd-1.0.0rc4.tar.gz.

File metadata

  • Download URL: lightusd-1.0.0rc4.tar.gz
  • Upload date:
  • Size: 5.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for lightusd-1.0.0rc4.tar.gz
Algorithm Hash digest
SHA256 dc17215df2863cf7c3e5015d40569e5602fa47fed62b8af3389c11c5c09206c8
MD5 0e2288e8fbb4e967eef764e2449216a8
BLAKE2b-256 bc374e404bf16b9710974a0238d7d727e42fcc8cb9864972a8b3a8c9b025d61e

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightusd-1.0.0rc4.tar.gz:

Publisher: wheels.yml on lighttransport/LightUSD

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightusd-1.0.0rc4-cp314-cp314t-win_arm64.whl.

File metadata

File hashes

Hashes for lightusd-1.0.0rc4-cp314-cp314t-win_arm64.whl
Algorithm Hash digest
SHA256 03781ce4484abbed67e09d5c3ce6f67f92cfa2a049357abb390be91caeab7d57
MD5 3094bb67fe3a8ec2d07a84594383cbcc
BLAKE2b-256 b636598f2d7f8aff975b3d2d14311af72fac42395127534211362d6ba3f556ed

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightusd-1.0.0rc4-cp314-cp314t-win_arm64.whl:

Publisher: wheels.yml on lighttransport/LightUSD

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightusd-1.0.0rc4-cp314-cp314t-win_amd64.whl.

File metadata

File hashes

Hashes for lightusd-1.0.0rc4-cp314-cp314t-win_amd64.whl
Algorithm Hash digest
SHA256 de47ae018214bf530a164fb37c3990de061cd2b92e839c463d73bf6720e1b0b8
MD5 5c721baaf69c4500a15379a2b2adaa00
BLAKE2b-256 134898b16dd03bac9f6f1ade6e0aa59f054d5990a4f8074c98e7bce95974d47f

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightusd-1.0.0rc4-cp314-cp314t-win_amd64.whl:

Publisher: wheels.yml on lighttransport/LightUSD

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightusd-1.0.0rc4-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for lightusd-1.0.0rc4-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 8daad5378bf6c5454247fc68771648d0c8919a599b0c7e70af01664aa2aa403c
MD5 2c6a500036c7079f97e9529fdf266174
BLAKE2b-256 095111f88bbf0a711c61ece5e0ae66d0ebbe2c0b9e68b3de2ab9415239f8b89d

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightusd-1.0.0rc4-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: wheels.yml on lighttransport/LightUSD

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightusd-1.0.0rc4-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for lightusd-1.0.0rc4-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 e8836e0b7f8df4893e356d58c7a459f73c97afcdb56c8068f11a47eef584938e
MD5 4180063f80dfe44142985d950488d7b0
BLAKE2b-256 3ac8f77795f1d08deb6bc43e66c73ddd036948feb917cd59036e3c7731615bf6

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightusd-1.0.0rc4-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl:

Publisher: wheels.yml on lighttransport/LightUSD

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightusd-1.0.0rc4-cp314-cp314t-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for lightusd-1.0.0rc4-cp314-cp314t-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 c87a146bdd4a5165e922d3b9fd98a40b9afc8da1c155c5629559527c33c2278b
MD5 8e2d4aca9d73b981618ac720df71b1f5
BLAKE2b-256 3a6555fa456616950b7e5f6568b9b8e2b2fe0bfa296e9e3b872e663c9c0b521a

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightusd-1.0.0rc4-cp314-cp314t-macosx_11_0_arm64.whl:

Publisher: wheels.yml on lighttransport/LightUSD

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightusd-1.0.0rc4-cp310-abi3-win_arm64.whl.

File metadata

  • Download URL: lightusd-1.0.0rc4-cp310-abi3-win_arm64.whl
  • Upload date:
  • Size: 939.5 kB
  • Tags: CPython 3.10+, Windows ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for lightusd-1.0.0rc4-cp310-abi3-win_arm64.whl
Algorithm Hash digest
SHA256 69bfc74acd5ebb6a9c23ba1ee3d4663ff17d489de75a0d9790e3ad53fb8ee73b
MD5 8be07bccadd4b98cdfe355eff5fd5aa3
BLAKE2b-256 f666fbfdae36550dabbfe199d170e1c11a6793522a568b8b504c3ed057acb71c

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightusd-1.0.0rc4-cp310-abi3-win_arm64.whl:

Publisher: wheels.yml on lighttransport/LightUSD

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightusd-1.0.0rc4-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: lightusd-1.0.0rc4-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 1.1 MB
  • Tags: CPython 3.10+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for lightusd-1.0.0rc4-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 a33a2e3250cb8d1bc9161a010e323aa3c51f2686795ca29fa5042696ade245b7
MD5 26784c3597acbfbe7a4dfec1ebcf5df1
BLAKE2b-256 3870c5f51f856bf0708b59c0509b9600e037514da76207747d670d2e9b03b3c6

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightusd-1.0.0rc4-cp310-abi3-win_amd64.whl:

Publisher: wheels.yml on lighttransport/LightUSD

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightusd-1.0.0rc4-cp310-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for lightusd-1.0.0rc4-cp310-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 6b27b147fbf9d6a1f8b854edee030dd21de414fd176bab9b279e035473cc1b00
MD5 4ea956de255d49997605c8551cc5bb6e
BLAKE2b-256 acc7b299f4bd03d350d086d0ccf50b41c59cb9cb009481e1537082951a9f29de

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightusd-1.0.0rc4-cp310-abi3-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: wheels.yml on lighttransport/LightUSD

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightusd-1.0.0rc4-cp310-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for lightusd-1.0.0rc4-cp310-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 fc94ee77ea628d303230cd0a7c5c5e736112b42a9593232d3417de566fe8f7a7
MD5 6c1ea5726a3aa51c95bc989fb550f62f
BLAKE2b-256 eb76a0c988f550cf6fb86db88e890c76a6db4b210ab836b652ccf23c938cdc52

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightusd-1.0.0rc4-cp310-abi3-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl:

Publisher: wheels.yml on lighttransport/LightUSD

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file lightusd-1.0.0rc4-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for lightusd-1.0.0rc4-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 7405201d7cc12c9092c521ea8a0145d90fe6920d51abdb2b6617f43ede6cf648
MD5 2460def7acaad7714e7c9b60dc2ae4ff
BLAKE2b-256 b5680beb42e0e3b01e5f391191184b00c3e3f92b524acc2f3a5c6ad01ed42de8

See more details on using hashes here.

Provenance

The following attestation bundles were made for lightusd-1.0.0rc4-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: wheels.yml on lighttransport/LightUSD

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release
Pre-release

1.0.0rc4 This release

11 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