This is the main repository for the MakeHuman application as such.
OTHER License
This is the main source code for the MakeHuman application as such. See "Getting started" below for instructions on how to get MakeHuman up and running. Mac users should be able to use the same instructions as windows users, although this has not been thoroughly tested.
At the point of writing this, the source code is almost ready for a stable release.
If you have any questions about the software and its usage, please make a request in our forum: http://www.makehumancommunity.org/forum.
A quick look through at least the top questions in the FAQ might be a good idea too: http://www.makehumancommunity.org/wiki/FAQ:Index
Please do not use the issue tracker for general tech support. For such questions, please use the forums.
The testing vision for this code is to build a community release that includes main application 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 application.
If you find a bug, please report it in the issues section here on github. In order to make a good bug report, please also include the logs: http://www.makehumancommunity.org/wiki/FAQ:How\_to\_provide\_a\_makehuman\_log\_for\_a\_good\_bug\_report%3F
Builds for Windows platforms can be downloaded from http://www.makehumancommunity.org/content/downloads.html
If you rather run the code from source:
MakeHuman depends on the following Python packages:
Additionaly MakeHuman's shell plugin can make use of IPython / Jupyter. You might also want to install these packages:
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
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
If you want to use community plugins like the asset downloader - download them, put in the plugins directory, enable in settings and restart app:
Having done this, you can now start MakeHuman by running the makehuman.py script. On a prompt run
Alternatively there is a shell script named makehuman to start the application on Linux systems.
There are three standard branches and some additional developer working branches:
Read-only reference branches
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.