This is now a near viable port of the current MakeHuman 1.1.1 stable branch to a Python 3 dependency. PyQt5 support was recently merged into this branch to replace pyside and pyQt4. This merge needs additional rigorous testeing.
Clone or download


This is a port of MakeHuman to Python 3 and PyQt5.

The testing vision for this code is to build a community release that includes the ported code and often-used, user-contributed plug-ins. We hope that the utility of this integrated functionality is sufficient to entice a larger cohort of testers who get value-added in exchange for the possibility of uncovering deficiencies in our port. When testing verifies it's robustness it should a suitable replacement for the current bitbucket code extending the future of MakeHuman beyond the Python 2 "end-of-life".

Support requests:

If you have any questions about the software and its usage, please make a request in our forum: We are not going to answer support requests on the bug tracker!

Current status


If you want a stable release of MakeHuman, see

This said, the code in the master branch will work if a few basic requirements are met:

  • You must use a graphics card capable of using the opengl calls MH rely on. It is currently not easy to say exactly which these are.

Getting started

Builds for Windows platforms can be downloaded at: These builds include all required dependencies.

If you rather run the code from source:

  • Install git ( with LFS support ( Modern git clients have LFS support included per default.
  • Make sure the command "git" is available via the PATH variable.
  • Install python 3.5.x or later from (or via your system's package management)
  • Figure out how to run "pip": (it should have been installed automatically by python), but on Linux use your default package menagemnt system
  • Use "pip" to install dependencies:
    • "pip install numpy"
    • "pip install PyQt5"
    • "pip install PyOpenGL"
  • on Debian based systems you need to install: python3-numpy, python3-opengl, python3-pyqt5, python3-pyqt5.opengl, python3-pyqt5.qtsvg
  • Use git to clone (or download the source as a zip)
  • Run the "" script in the "makehuman" subdirectory of the source code.
  • Optionally also run:

Having done this, you can now start MakeHuman by running the script.


There are three standard branches and some additional developer working branches:

  • master: This is where you will find the latest version of MakeHuman.

Read-only reference branches

  • bitbucket-stable: This is the code as it looks in the "stable" branch at bitbucket. This is the ancestor of what is now the "master" branch.
  • bitbucket-default: This is the code as it looks in the "default" branch at bitbucket.

In addition you may from time to time see feature branches (usually named _feature...), which are removed after having been merged to the master branch.