FAQ:How can I run MakeHuman from a BitBucket source clone?

From MakeHuman Community Wiki
Revision as of 08:49, 30 August 2015 by Joepal (Talk | contribs)

Jump to: navigation, search

Contrary to popular opinion it is not all that difficult to run MakeHuman directly from source. Doing so has the following benefits:

  • You get full access to all assets (ie you are not restricted to only compiled/processed/compressed versions)
  • You can "update" the MakeHuman directory and thereby download only the latest changes instead of having to download and unzip a big binary each time a change has been made.

General steps for installation

These are the steps which are needed in general

  • Install dependencies
  • Get a mercurial client (it's what's needed for downloading the source code)
  • Download the source code
  • Run the script for downloading assets

General steps for updating

Once the installation has been made, these are the steps which is needed to get up to date with the latest version

  • Run mercurial pull + mercurial update
  • Run the script for downloading assets

Linux

The easiest platform for doing all this is linux. This is what you do for installation:

   sudo apt-get install python python-numpy python-opengl python-qt4 python-qt4-gl mercurial
   hg clone https://bitbucket.org/MakeHuman/makehuman
   cd makehuman/makehuman
   python download_assets.py

To update:

   cd makehuman 
   hg pull && hg update -C
   python download_assets.py

To start makehuman:

   cd makehuman/makehuman
   python makehuman.py

Windows

On windows you need to install the dependencies manually. However, in order to ease this process, there is a zip file with all that is needed, see http://files.jwp.se/makehuman.html

To install:

  • Install everything in the zip file above. There is a readme in the file with instructions.
  • Create a directory "makehuman" (or whatever you want to call it).
  • Right-click the directory and choose tortoisehg ... clone
  • Paste https://bitbucket.org/MakeHuman/makehuman in the text box for source
  • Open your directory and the "makehuman" subdir which is now inside it
  • Double-click "download_assets.py"

To update:

  • Right-click the directory and choose tortoisehg ... update
  • Open your directory and the "makehuman" subdir which is inside it
  • Double-click "download_assets.py"

To run:

  • Open your directory and the "makehuman" subdir which is inside it
  • Double-click "makehuman.py"

Mac

Unfortunately no-one of the devs run Mac. You will have to figure out the procedure on your own given the above.

If you have managed to make an installation this way, pasting the procedure here would be a good deed.

Tutorial video

There is a tutorial video on how to make a "full" installation of MakeHuman and related tools on windows. This is up to date apart from the location of the zip file which is mentioned above.