Difference between revisions of "FAQ:How can I run MakeHuman from a BitBucket source clone?"

From MakeHuman Community Wiki
Jump to: navigation, search
Line 52: Line 52:
  
 
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 . Another option is to install Python 2.7 from the WinPython project (see http://sourceforge.net/projects/winpython/files/WinPython_2.7/). It is recommended to use the 32bit version of WinPython.
 
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 . Another option is to install Python 2.7 from the WinPython project (see http://sourceforge.net/projects/winpython/files/WinPython_2.7/). It is recommended to use the 32bit version of WinPython.
 +
 
To install:
 
To install:
  

Revision as of 12:46, 10 October 2015

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 (i.e. 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.

The source code is hosted on BitBucket and as version control system Mercurial is used. (see https://mercurial.selenic.com/). Downloading from BitBucket will pull a nightly build (FAQ:What is a nightly build?).

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). On Windows it's best to get TortoiseHg (see http://tortoisehg.bitbucket.org/download/index.html). On Linux you should find mercurial in your package manager.
  • 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
  • Find and remove old pyc-files

Linux

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

   sudo apt-get install python2.7 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
   cd makehuman
   python download_assets.py
   ./cleanpyc.sh
   ./cleannpz.sh
   python compile_models.py
   python compile_proxies.py
   python compile_targets.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 . Another option is to install Python 2.7 from the WinPython project (see http://sourceforge.net/projects/winpython/files/WinPython_2.7/). It is recommended to use the 32bit version of WinPython.

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.