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

From MakeHuman Community Wiki
Jump to: navigation, search
(Windows)
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
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)
+
== MH 1.1 (stable) ==
* You can "update" the MakeHuman directory and thereby download only the latest 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
+
Contrary to popular opinion it is not all that difficult to run MakeHuman directly from source. Doing so has the following benefits:
 
+
* 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 <nowiki>https://bitbucket.org/MakeHuman/makehuman</nowiki>
+
    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 <nowiki>https://bitbucket.org/MakeHuman/makehuman</nowiki> 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 ==
+
* 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. (This requires the usage of Mercurial)
  
Unfortunately no-one of the devs run Mac. You will have to figure out the procedure on your own given the above.
+
MakeHuman code is pure Python based. To run MakeHuman from source you need to install the following dependencies: Python 2.7, NumPy, PyOpenGl and PyQt for Qt4. The link to the source code is in the download section. You can either get the code as a zip-file or download it with the version control tool Mercurial.
  
If you have managed to make an installation this way, pasting the procedure here would be a good deed.
+
The full procedure with platform specific notes is documented in [[Documentation:Running_MakeHuman_from_source|Running MakeHuman from Source]].
  
== Tutorial video ==
+
== MH 1.2 (unstable) ==
  
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.
 
  
{{#ev:youtube|3CCHGX-6Mtk}}
+
If you're looking for the source code of the upcoming MakeHuman 1.2.0 go to [https://github.com/makehumancommunity/makehuman https://github.com/makehumancommunity/makehuman]. You'll also find basic instructions on how to get started on this page.

Latest revision as of 10:40, 10 May 2019

MH 1.1 (stable)

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. (This requires the usage of Mercurial)

MakeHuman code is pure Python based. To run MakeHuman from source you need to install the following dependencies: Python 2.7, NumPy, PyOpenGl and PyQt for Qt4. The link to the source code is in the download section. You can either get the code as a zip-file or download it with the version control tool Mercurial.

The full procedure with platform specific notes is documented in Running MakeHuman from Source.

MH 1.2 (unstable)

If you're looking for the source code of the upcoming MakeHuman 1.2.0 go to https://github.com/makehumancommunity/makehuman. You'll also find basic instructions on how to get started on this page.