Registry / ai-ml / cuequivariance-torch

cuequivariance-torch

JSON →
library0.10.0pypypiunverified

cuequivariance-torch provides CUDA-accelerated implementations of equivariant operations for PyTorch. It aims to efficiently handle geometric symmetries in deep learning models, particularly for 3D data, by offering modules for SO(3) rotations and SE(3) translations. The current version is 0.9.1, and it maintains an active development pace with new features and optimizations.

pip install cuequivariance-torch
INSTALL
IMPORT
SIG · CUEQUIVARIANCE-TOR
C
cuequivariance-torch
ai-mlpythonv0.10.0
Install
13.3s avg
Import
Disk
322MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v0.10.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.920 runs
installs and imports cleanly · install 0.0s · import 0.000s · 308.2MB
glibc
py 3.103.920 runs
installs and imports cleanly · install 13.3s · import 0.000s · 299MB
322MB installed
● package 322MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

SO3Linear
from cuequivariance_torch import SO3Linear
from cuequivariance_torch import SO3Linear

This quickstart demonstrates how to initialize and use an `SO3Linear` layer, a core module for SO(3) equivariant operations, ensuring that both the input tensor and the model are correctly placed on a CUDA device.

import torch from cuequivariance.modules import SO3Linear # Ensure CUDA is available if not torch.cuda.is_available(): raise RuntimeError("CUDA is not available. cu-equivariance-torch requires a CUDA-enabled PyTorch installation with a GPU.") # Define device device = torch.device("cuda") # Example: SO(3) Linear layer for rotation matrices # Input dimensions: (batch, features_in, 3, 3) where the last two dimensions represent a 3x3 matrix batch_size = 4 features_in = 16 features_out = 32 # Create a dummy input tensor on the CUDA device # For SO3Linear, the input tensor's last two dimensions are treated as matrix components. # The layer handles the equivariant operations. input_data = torch.randn(batch_size, features_in, 3, 3, device=device) # Instantiate an SO(3) Linear layer and move it to the CUDA device so3_linear_layer = SO3Linear(features_in, features_out).to(device) # Pass the input through the layer output_data = so3_linear_layer(input_data) print(f"Input shape: {input_data.shape}, device: {input_data.device}") print(f"Output shape: {output_data.shape}, device: {output_data.device}") # Expected output shape: (batch_size, features_out, 3, 3)
Debug
Known issues
breakingThe library explicitly requires PyTorch 2.1 or newer. Older versions of PyTorch or PyTorch installations without CUDA will not work.
fix
Ensure your PyTorch installation is `torch>=2.1` and is built with CUDA support (e.g., install `torch` using a command that specifies CUDA, such as from the official PyTorch website).
affects: <0.9.0
gotchaThe PyPI package name is `cuequivariance-torch`, but the Python import name is `cuequivariance`.
fix
Always use `from cuequivariance import ...` or `from cuequivariance.modules import ...` for imports, not `cuequivariance_torch`.
affects: All versions
gotchaThis library is CUDA-accelerated and strictly requires a CUDA-enabled GPU and a PyTorch installation compiled with CUDA. It will not function on CPU-only setups.
fix
Verify that `torch.cuda.is_available()` returns `True`. If not, ensure you have a CUDA-compatible GPU, the necessary drivers, and PyTorch installed with CUDA support.
affects: All versions
Upgrade
Version history
0.10.0latest on PyPI · released Apr 22, 2026
Audit
Dependencies
torch>=2.1requiredRequires PyTorch 2.1 or newer with CUDA enabled for core functionality.
Agent activity
55 hits · last 30 days
node
48
OpenAI (training)
1
Resources
cuequivariance-torch — pip install cuequivariance-torch · libregistry