gltf_draco_transcoder

A high-performance Python package for compressing and decompressing glb files using the Draco 3D data compression library. This package provides both a Python API and a command-line interface for efficient 3D model compression.

Features

Compression: Compress glb files using Draco compression to reduce file sizes significantly
Decompression: Decompress Draco-compressed glb files back to standard glTF format
High Performance: C++ backend with Python bindings for maximum performance
Cross-platform: Supports Windows, macOS (ARM64), and Linux (x86_64 and ARM64)
Configurable: Fine-tune compression quality with quantization and compression level settings
Easy Integration: Simple Python API and command-line interface

Live Demo

Try the online demo to see Draco compression in action on glTF files. The demo uses the WebAssembly (WASM) port of the same C++ codebase as this Python package.

Installation

Install from PyPI:

pip install gltf_draco_transcoder

Usage

Python API

Basic Compression

from gltf_draco_transcoder import compress_gltf, decompress_gltf

# Compress a glb file
compressed_data = compress_gltf('input.glb')

# Save compressed data
with open('output_compressed.glb', 'wb') as f:
    f.write(compressed_data.getvalue())

# Decompress back to glb
decompressed_data = decompress_gltf('output_compressed.glb')
with open('output_decompressed.glb', 'wb') as f:
    f.write(decompressed_data.getvalue())

Advanced Compression with Custom Options

from gltf_draco_transcoder import compress_gltf

# Compress with custom quantization and compression level settings
# qp: quantization_position, qn: quantization_normal, cl: compression_level
compressed_data = compress_gltf('input.glb', qp=14, qn=10, cl=9)

Command Line Interface

Compress a glb file:

python -m gltf_draco_transcoder input.glb output_compressed.glb

This will display compression statistics including file sizes and compression ratio.

Compression Options

The compress_gltf function accepts the following parameters:

Quantization Bits (default values shown):
- qp=11: Position quantization
- qt=10: Texture coordinate quantization
- qn=8: Normal vector quantization
- qc=8: Color quantization
- qtg=8: Tangent quantization
- qw=8: Weight quantization
- qg=8: Generic attribute quantization
Compression Level:
- cl=7: Compression effort (0-10, higher = better compression but slower)

Higher quantization bits = better quality but larger file sizes. Higher compression levels = better compression ratios but slower processing.

Development

Building from Source

This project uses scikit-build-core with CMake and vcpkg for dependency management.

Prerequisites

Python 3.10+
CMake 3.15+
Git
vcpkg (automatically installed on Linux via CI scripts)

Build Steps

# Clone the repository
git clone https://github.com/gongfan99/gltf_draco_transcoder.git
cd gltf_draco_transcoder

# Install build dependencies
pip install scikit-build-core setuptools-scm

# Build the package
python -m build

Project Structure

src/gltf_draco_transcoder/
├── __init__.py          # Main API exports
├── loader.py            # Python wrapper and ctypes bindings
├── py.typed             # Type hints marker
└── _version.py          # Version information (auto-generated)

cpp/
├── draco_transcoder_c_api.*    # C API wrapper
└── draco_transcoder_lib.*      # Core C++ implementation

vcpkg-overlays/draco/           # Custom Draco build configuration
vcpkg-triplets/                 # Platform-specific build triplets

Platform Support

Linux: x86_64 and ARM64 (manylinux/musllinux wheels)
macOS: ARM64
Windows: x86_64 (win_amd64 wheels)

Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues on GitHub.

License

This project is licensed under the Apache License Version 2.0 - see the LICENSE file for details.

Credits

Built on the Draco 3D data compression library
Uses tinygltf for glTF file I/O
Uses vcpkg for dependency management
Packaging with scikit-build-core and cibuildwheel

Download files

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

Source Distribution

gltf_draco_transcoder-0.3.1.tar.gz (38.8 kB view details)

Uploaded Jan 14, 2026 Source

Built Distributions

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

gltf_draco_transcoder-0.3.1-py3-none-win_amd64.whl (474.4 kB view details)

Uploaded Jan 14, 2026 Python 3Windows x86-64

gltf_draco_transcoder-0.3.1-py3-none-musllinux_1_2_x86_64.whl (3.8 MB view details)

Uploaded Jan 14, 2026 Python 3musllinux: musl 1.2+ x86-64

gltf_draco_transcoder-0.3.1-py3-none-musllinux_1_2_aarch64.whl (3.6 MB view details)

Uploaded Jan 14, 2026 Python 3musllinux: musl 1.2+ ARM64

gltf_draco_transcoder-0.3.1-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (2.7 MB view details)

Uploaded Jan 14, 2026 Python 3manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

gltf_draco_transcoder-0.3.1-py3-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl (2.5 MB view details)

Uploaded Jan 14, 2026 Python 3manylinux: glibc 2.27+ ARM64manylinux: glibc 2.28+ ARM64

gltf_draco_transcoder-0.3.1-py3-none-macosx_11_0_arm64.whl (1.7 MB view details)

Uploaded Jan 14, 2026 Python 3macOS 11.0+ ARM64

File details

Details for the file gltf_draco_transcoder-0.3.1.tar.gz.

File metadata

Download URL: gltf_draco_transcoder-0.3.1.tar.gz
Upload date: Jan 14, 2026
Size: 38.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for gltf_draco_transcoder-0.3.1.tar.gz
Algorithm	Hash digest
SHA256	`a79a4198d47a191b6d4c27aade33203144b73028d9b92aacf8db639338b2e08a`
MD5	`36dac1005a677b1f01d7a9799e86a1c9`
BLAKE2b-256	`91d090aa8001fd0cf795aa8c3c1c6b9f08396dea4810318cea831d14e26b38f0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for gltf_draco_transcoder-0.3.1.tar.gz:

Publisher: build_wheels.yml on gongfan99/gltf_draco_transcoder

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: gltf_draco_transcoder-0.3.1.tar.gz
- Subject digest: a79a4198d47a191b6d4c27aade33203144b73028d9b92aacf8db639338b2e08a
- Sigstore transparency entry: 820652414
- Sigstore integration time: Jan 14, 2026
Source repository:
- Permalink: gongfan99/gltf_draco_transcoder@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/gongfan99
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: build_wheels.yml@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Trigger Event: push

File details

Details for the file gltf_draco_transcoder-0.3.1-py3-none-win_amd64.whl.

File metadata

Download URL: gltf_draco_transcoder-0.3.1-py3-none-win_amd64.whl
Upload date: Jan 14, 2026
Size: 474.4 kB
Tags: Python 3, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for gltf_draco_transcoder-0.3.1-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`ab07cba014304f3399f9f34ffddacd40526b3dec88eec7e722e1874be296b7eb`
MD5	`347cabdcc52d4a4fb1d7408db0155faf`
BLAKE2b-256	`f313f0ad877046ac26ba48e81592b67dcda0ea43dd363c651cd43c8ea57ed168`

See more details on using hashes here.

Provenance

The following attestation bundles were made for gltf_draco_transcoder-0.3.1-py3-none-win_amd64.whl:

Publisher: build_wheels.yml on gongfan99/gltf_draco_transcoder

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: gltf_draco_transcoder-0.3.1-py3-none-win_amd64.whl
- Subject digest: ab07cba014304f3399f9f34ffddacd40526b3dec88eec7e722e1874be296b7eb
- Sigstore transparency entry: 820652428
- Sigstore integration time: Jan 14, 2026
Source repository:
- Permalink: gongfan99/gltf_draco_transcoder@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/gongfan99
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: build_wheels.yml@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Trigger Event: push

File details

Details for the file gltf_draco_transcoder-0.3.1-py3-none-musllinux_1_2_x86_64.whl.

File metadata

Download URL: gltf_draco_transcoder-0.3.1-py3-none-musllinux_1_2_x86_64.whl
Upload date: Jan 14, 2026
Size: 3.8 MB
Tags: Python 3, musllinux: musl 1.2+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for gltf_draco_transcoder-0.3.1-py3-none-musllinux_1_2_x86_64.whl
Algorithm	Hash digest
SHA256	`e6050f711fb18391303a53d2ec1b50e6b92b3d262e2fa1eeb1bc777329f4ec2e`
MD5	`251d47ef70d9cb01f619764447cc8da4`
BLAKE2b-256	`900a9eea6ff899540b5562498a2cc72fded35dd695833104d121894a307c7d7b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for gltf_draco_transcoder-0.3.1-py3-none-musllinux_1_2_x86_64.whl:

Publisher: build_wheels.yml on gongfan99/gltf_draco_transcoder

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: gltf_draco_transcoder-0.3.1-py3-none-musllinux_1_2_x86_64.whl
- Subject digest: e6050f711fb18391303a53d2ec1b50e6b92b3d262e2fa1eeb1bc777329f4ec2e
- Sigstore transparency entry: 820652421
- Sigstore integration time: Jan 14, 2026
Source repository:
- Permalink: gongfan99/gltf_draco_transcoder@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/gongfan99
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: build_wheels.yml@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Trigger Event: push

File details

Details for the file gltf_draco_transcoder-0.3.1-py3-none-musllinux_1_2_aarch64.whl.

File metadata

Download URL: gltf_draco_transcoder-0.3.1-py3-none-musllinux_1_2_aarch64.whl
Upload date: Jan 14, 2026
Size: 3.6 MB
Tags: Python 3, musllinux: musl 1.2+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for gltf_draco_transcoder-0.3.1-py3-none-musllinux_1_2_aarch64.whl
Algorithm	Hash digest
SHA256	`f382399dac7946b45823d405831a0f99a734f79ebb620c2e33829ba04390287a`
MD5	`747c74646d9b13e8c7ad3e9b3fe54d39`
BLAKE2b-256	`4f3dc80e8d4a590090c4d14f1930ef87c12cff0fcc35d90c0532b9276bb01280`

See more details on using hashes here.

Provenance

The following attestation bundles were made for gltf_draco_transcoder-0.3.1-py3-none-musllinux_1_2_aarch64.whl:

Publisher: build_wheels.yml on gongfan99/gltf_draco_transcoder

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: gltf_draco_transcoder-0.3.1-py3-none-musllinux_1_2_aarch64.whl
- Subject digest: f382399dac7946b45823d405831a0f99a734f79ebb620c2e33829ba04390287a
- Sigstore transparency entry: 820652432
- Sigstore integration time: Jan 14, 2026
Source repository:
- Permalink: gongfan99/gltf_draco_transcoder@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/gongfan99
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: build_wheels.yml@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Trigger Event: push

File details

Details for the file gltf_draco_transcoder-0.3.1-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl.

File metadata

Download URL: gltf_draco_transcoder-0.3.1-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Upload date: Jan 14, 2026
Size: 2.7 MB
Tags: Python 3, manylinux: glibc 2.27+ x86-64, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for gltf_draco_transcoder-0.3.1-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`729cd97b570b81c97cae47c6602ff28ea32bb95f70cf9b9c94ecb9f00bbab4b4`
MD5	`013270b16f79043ca9e0a0d2f51ed664`
BLAKE2b-256	`6db621ceb76908bc34949676db03b5aa04b23a427680089b20529e44b10bca85`

See more details on using hashes here.

Provenance

The following attestation bundles were made for gltf_draco_transcoder-0.3.1-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl:

Publisher: build_wheels.yml on gongfan99/gltf_draco_transcoder

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: gltf_draco_transcoder-0.3.1-py3-none-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl
- Subject digest: 729cd97b570b81c97cae47c6602ff28ea32bb95f70cf9b9c94ecb9f00bbab4b4
- Sigstore transparency entry: 820652429
- Sigstore integration time: Jan 14, 2026
Source repository:
- Permalink: gongfan99/gltf_draco_transcoder@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/gongfan99
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: build_wheels.yml@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Trigger Event: push

File details

Details for the file gltf_draco_transcoder-0.3.1-py3-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl.

File metadata

Download URL: gltf_draco_transcoder-0.3.1-py3-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Upload date: Jan 14, 2026
Size: 2.5 MB
Tags: Python 3, manylinux: glibc 2.27+ ARM64, manylinux: glibc 2.28+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for gltf_draco_transcoder-0.3.1-py3-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
Algorithm	Hash digest
SHA256	`21d2b06099caf542ac0e1fb5ca3faf7a09e35a3dbe63c5f06a85cd06ba1fe3e1`
MD5	`634756df4d6b48303d95194f65f63a54`
BLAKE2b-256	`4157396b30e1bc03e0f7856763d16888ee0a43e20e0f26d0dd546bda13a7243d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for gltf_draco_transcoder-0.3.1-py3-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl:

Publisher: build_wheels.yml on gongfan99/gltf_draco_transcoder

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: gltf_draco_transcoder-0.3.1-py3-none-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl
- Subject digest: 21d2b06099caf542ac0e1fb5ca3faf7a09e35a3dbe63c5f06a85cd06ba1fe3e1
- Sigstore transparency entry: 820652416
- Sigstore integration time: Jan 14, 2026
Source repository:
- Permalink: gongfan99/gltf_draco_transcoder@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/gongfan99
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: build_wheels.yml@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Trigger Event: push

File details

Details for the file gltf_draco_transcoder-0.3.1-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: gltf_draco_transcoder-0.3.1-py3-none-macosx_11_0_arm64.whl
Upload date: Jan 14, 2026
Size: 1.7 MB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for gltf_draco_transcoder-0.3.1-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`364e318fb9ccd90341bd1069bd37a065b512fdf286cc99e4ab9c266756b049ee`
MD5	`1563bce871a811eb88880b9814652cb5`
BLAKE2b-256	`f3bfd310de927d7275c9c6b736fd5e0372c999741c58e70d84563b38be1c167b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for gltf_draco_transcoder-0.3.1-py3-none-macosx_11_0_arm64.whl:

Publisher: build_wheels.yml on gongfan99/gltf_draco_transcoder

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: gltf_draco_transcoder-0.3.1-py3-none-macosx_11_0_arm64.whl
- Subject digest: 364e318fb9ccd90341bd1069bd37a065b512fdf286cc99e4ab9c266756b049ee
- Sigstore transparency entry: 820652425
- Sigstore integration time: Jan 14, 2026
Source repository:
- Permalink: gongfan99/gltf_draco_transcoder@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Branch / Tag: refs/tags/v0.3.1
- Owner: https://github.com/gongfan99
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: build_wheels.yml@b12ea0d0c6e523c0d20323e8f3789c01e4c20a06
- Trigger Event: push

Release history Release notifications | RSS feed

This release

0.3.1 This release

Jan 14, 2026 7 files

Jan 14, 2026 7 files

Jan 3, 2026 7 files

Jan 3, 2026 7 files

Dec 31, 2025 7 files

Dec 31, 2025 7 files

Dec 31, 2025 7 files

Dec 31, 2025 7 files

Dec 31, 2025 7 files

gltf-draco-transcoder 0.3.1

gltf_draco_transcoder

Features

Live Demo

Installation

Usage

Python API

Basic Compression

Advanced Compression with Custom Options

Command Line Interface

Compression Options

Development

Building from Source

Prerequisites

Build Steps

Project Structure

Platform Support

Contributing

License

Credits

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed