Cloudflare Pages static PyPI simple index

CycloneDDS Prebuilt Binaries

A static repository of prebuilt CycloneDDS Python wheels for aarch64 Linux.

The official cyclonedds-python project publishes relatively few prebuilt binaries. On Unitree devices, installation often falls back to building CycloneDDS from source first. This site provides a static PyPI Simple Repository API endpoint for those wheels.

Build context

Problem source and build environments

Why these wheels exist

The upstream cyclonedds-python releases have limited prebuilt binary coverage, especially for Linux aarch64 robot images. Without a matching wheel, installation commonly requires compiling the CycloneDDS C library and Python bindings from source.

Current wheel environments

Device / image Python version CycloneDDS versions
Thor, JetPack 7.0, L4T 38.2.1, Unitree factory image CPython 3.12 (cp312) 0.10.2, 0.10.5*, 11.0.1
Orin NX, JetPack 5.1.1, L4T 35.3.1, Unitree factory image CPython 3.8 (cp38) 0.10.2, 0.10.5

* marks a tested version.

If this index does not have a wheel for your Python, CycloneDDS, or device image combination, run build_cyclonedds_wheels.sh on the target environment.

Install

Usage

Usage

Keep PyPI as the primary index and add this wheel index:

pip install --extra-index-url https://pypi.cyoahs.dev/simple cyclonedds

Install only from this index:

pip install --index-url https://pypi.cyoahs.dev/simple cyclonedds

Unitree SDK2 Python compatibility note

On Python versions newer than 3.10, unitree_sdk2_python with cyclonedds==0.10.2 may hit a buffer overflow around ChannelFactoryInitialize; see unitreerobotics/unitree_sdk2_python#90.

Install unitree_sdk2_python first, then override CycloneDDS with a newer wheel from this index:

pip install --upgrade --extra-index-url https://pypi.cyoahs.dev/simple cyclonedds==0.10.5

Maintain

Static file maintenance

Build wheels

build_cyclonedds_wheels.sh builds the CycloneDDS C library, builds Python wheels, runs auditwheel, and writes versioned outputs under wheelhouse.

./build_cyclonedds_wheels.sh 0.10.2 0.10.5 11.0.1

After updating wheels, place files under public/packages and keep the static index pages under public/simple in sync.