Builds for Windows platforms can be downloaded from http://www.makehumancommunity.org/content/downloads.html

If you rather run the code from source:

• Install python 3.6.x or later from https://www.python.org/ (or via your system's package management). On windows you MUST use 64-bit python. 32-bit python will not work.
• Install python dependencies (see the Installing python dependencies section below)
• 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.
• Use git to clone https://github.com/makehumancommunity/makehuman.git (or download the source as a zip)
• Run the "download_assets_git.py" script in the "makehuman" subdirectory of the source code.
• Optionally also run:
  • compile_models.py
  • compile_proxies.py
  • compile_targets.py

Installing python dependencies

MakeHuman depends on the following Python packages:

• numpy
• PyQt5
• PyOpenGL

Additionaly MakeHuman's shell plugin can make use of IPython / Jupyter. You might also want to install these packages:

• jupyterlab
• qtconsole

Installing python core dependencies on Linux

It is recommended to install the aforementioned packages via the package manager of the operating system.

• Debian / Ubuntu / Mint:

  apt install python3-opengl python3-pyqt5 python3-pyqt5.qtopengl python3-pyqt5.qtsvg

• openSUSE:

  zypper install python3-numpy python3-qt5 python3-opengl

An alternative way to install dependencies is using pip. However, it is best practice to set up an virtual environment and activate it before using Python's package manager on a Linux system. For convenience, you might want to run:

pip install -r requirements.txt

Installing python core dependencies on Windows

You should be able to start the command "pip" by opening a console prompt ("run" -> "cmd.exe") and writing "pip". If not, figure out how to run pip (it should have been installed by python automatically):

Use pip to install dependencies. Running the following command will install all python dependencies:

pip install -r requirements.txt

Installing plugins

If you want to use community plugins like the asset downloader - download them, put in the plugins directory, enable in settings and restart app:

• https://github.com/makehumancommunity/community-plugins-mhapi
• https://github.com/makehumancommunity/community-plugins-assetdownload
• https://github.com/makehumancommunity/community-plugins-socket
• https://github.com/makehumancommunity/makehuman-plugin-for-blender

Starting MakeHuman

Having done this, you can now start MakeHuman by running the makehuman.py script. On a prompt run

• python makehuman.py (on Windows)
• python3 makehuman.py (on Debian, Ubuntu, Mint...)

Alternatively there is a shell script named makehuman to start the application on Linux systems.