Skip to main content

Python bindings for the Open Asset Import Library (ASSIMP)

Project description

A simple Python wrapper for Assimp using ctypes to access the library. Requires Python >= 2.6.

Python 3 support is mostly here, but not well tested.

Note that pyassimp is not complete. Many ASSIMP features are missing.


Complete example: 3D viewer

pyassimp comes with a simple 3D viewer that shows how to load and display a 3D model using a shader-based OpenGL pipeline.



To use it, from within /port/PyAssimp:

$ cd scripts
$ python ./3D-viewer <path to your model>

You can use this code as starting point in your applications.

Writing your own code

To get started with pyassimp, examine the simpler script in scripts/, which illustrates the basic usage. All Assimp data structures are wrapped using ctypes. All the data+length fields in Assimp’s data structures (such as aiMesh::mNumVertices, aiMesh::mVertices) are replaced by simple python lists, so you can call len() on them to get their respective size and access members using [].

For example, to load a file named hello.3ds and print the first vertex of the first mesh, you would do (proper error handling substituted by assertions …):

from pyassimp import load
with load('hello.3ds') as scene:

    assert len(scene.meshes)
    mesh = scene.meshes[0]

    assert len(mesh.vertices)

Another example to list the ‘top nodes’ in a scene:

from pyassimp import load
with load('hello.3ds') as scene:

    for c in scene.rootnode.children:


Install pyassimp by running:

$ python install

PyAssimp requires a assimp dynamic library (DLL on windows, .so on linux, .dylib on macOS) in order to work. The default search directories are:

  • the current directory

  • on linux additionally: /usr/lib, /usr/local/lib, /usr/lib/x86_64-linux-gnu

To build that library, refer to the Assimp master INSTALL instructions. To look in more places, edit ./pyassimp/ There’s an additional_dirs list waiting for your entries.

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

pyassimp-5.2.5.tar.gz (101.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page