Skip to main content

Python library for reading, writing and managing 3D objects in the Khronos Group gltf and gltf2 formats. Python 3.6+

Project description


Python library for reading, writing and handling GLTF files. Python3.6+


  • Python 3.6
  • dataclasses
  • dataclasses-json
  • numpy


This is an unofficial library that tracks the official file format for GLTF2.

The library was initially built to load and save simple meshes but support for the entire spec, including materials and animations is pretty good. Check the table below for an idea of which sample models validate.

Questions? Contributions? Bug reports? Open an issue on the gitlab page for the project.


  • Luke Miller
  • Sebastian Höffner


  • 1.0 initial release.
  • 1.2 better json support, remove numpy requirement, suppress infer warning, basic default methods.
  • 1.3 basic support for reading binary GLTF (.glb) files.


  • Add helper functions for creating meshes
  • Full support for binary GLTF (.glb) files.



Method 1

pip install pygltflib

Method 2

python -m pip install pygltflib

Method 3

py -3 -m pip install pygltflib


git clone


Note: These examples use the official sample models provided by Kronos at:


>>> from pygltflib import GLTF2, Scene
>>> gltf = GLTF2()
>>> gltf.scene # no scene set by default
>>> len(gltf.scenes)

>>> scene = Scene()
>>> gltf.scenes.append(scene)
>>> len(gltf.scenes)

Loading and saving

pygltflib can load json-based .GLTF files and binary .GLB files, based on the file extension. Support for saving files loaded from .GLB is currently not fully implemented.

GLTF files

>>> from pygltflib import GLTF2
>>> filename = "glTF-Sample-Models/2.0/AnimatedCube/glTF/AnimatedCube.gltf"
>>> gltf = GLTF2().load(filename)
>>> gltf.scene

>>> gltf.scenes
[Scene(name='', nodes=[0])]

>>> gltf.nodes[0]
Node(mesh=0, name='AnimatedCube', rotation=[0.0, -1.0, 0.0, 0.0])

>>> gltf.nodes[0].name

>>> gltf.meshes[0].primitives[0].attributes

>>> filename2 = "test.gltf"
>>> gltf = GLTF2().save(filename2)

GLB files

>>> from pygltflib import GLTF2
>>> glb_filename = "glTF-Sample-Models/2.0/Box/glTF-Binary/Box.glb"
>>> glb = GLTF2().load(glb_filename)
>>> glb.scene

>>> glb.scenes
[Scene(name='', nodes=[0])]

>>> glb.nodes[0]
Node(mesh=0, name='AnimatedCube', rotation=[0.0, -1.0, 0.0, 0.0])

>>> glb.nodes[0].name

>>> glb.meshes[0].primitives[0].attributes

Running the tests

Status of gltf-validator

Using sample models loaded and then saved using this library, here are validator reports (blank is untested).

Model Validator Status
2CylinderEngine passes
AlphaBlendModeTest passes
AnimatedCube passes
AnimatedMorphCube passes
AnimatedMorphSphere passes
AnimatedTriangle passes
Avocado passes
BarramundiFish passes
BoomBox passes
BoomBoxWithAxes passes
Box passes
BoxAnimated passes
BoxInterleaved passes
BoxTextured passes
BoxTexturedNonPowerOfTwo passes
BoxVertexColors passes
BrainStem passes
Buggy passes
Cameras passes
CesiumMan passes
CesiumMilkTruck passes
Corset passes
Cube passes
DamagedHelmet passes
Duck passes
FlightHelmet passes
GearboxAssy passes
Lantern passes
MetalRoughSpheres passes
Monster passes
MultiUVTest passes
NormalTangentMirrorTest passes
NormalTangentTest passes
OrientationTest passes
ReciprocatingSaw passes
RiggedFigure passes
RiggedSimple passes
SciFiHelmet passes
SimpleMeshes passes
SimpleMorph passes
SimpleSparseAccessor passes
SpecGlossVsMetalRough passes
Sponza passes
Suzanne passes
TextureCoordinateTest passes
TextureSettingsTest passes
TextureTransformTest passes
Triangle passes
TriangleWithoutIndices passes
TwoSidedPlane passes
VC passes
VertexColorTest passes
WaterBottle passes


python -m tests

Project details

Download files

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

Source Distribution

pygltflib-1.3.tar.gz (7.6 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page