You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: README.md
+38-8
Original file line number
Diff line number
Diff line change
@@ -30,10 +30,10 @@ Builds for Windows platforms can be downloaded from http://www.makehumancommunit
30
30
31
31
If you rather run the code from source:
32
32
33
-
* Install git (https://git-scm.com/) with LFS support (https://git-lfs.github.com/). Modern git clients have LFS support included per default.
34
-
* Make sure the command "git" is available via the PATH variable.
35
33
* 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.
36
34
* Install python dependencies (see the [Installing python dependencies](#installing-python-dependencies) section below)
35
+
* Install [git](https://git-scm.com/) with [LFS support](https://git-lfs.github.com/). Modern git clients have LFS support included per default.
36
+
* Make sure the command "git" is available via the PATH variable.
37
37
* Use git to clone https://github.com/makehumancommunity/makehuman.git (or download the source as a zip)
38
38
* Run the "download\_assets\_git.py" script in the "makehuman" subdirectory of the source code.
39
39
* Optionally also run:
@@ -42,12 +42,41 @@ If you rather run the code from source:
42
42
* compile\_targets.py
43
43
44
44
### Installing python dependencies
45
+
MakeHuman depends on the following Python packages:
46
+
47
+
* numpy
48
+
* PyQt5
49
+
* PyOpenGL
50
+
51
+
Additionaly MakeHuman's shell plugin can make use of [IPython / Jupyter](https://jupyter.org/). You might also want to install these packages:
52
+
53
+
* jupyterlab
54
+
* qtconsole
55
+
56
+
#### Installing python core dependencies on Linux
57
+
It is recommended to install the aforementioned packages via the package manager of the operating system.
An alternative way to install dependencies is using __pip__. However, it is best practice to set up an [virtual environment](https://docs.python.org/3/library/venv.html)
68
+
and activate it before using Python's package manager on a Linux system.
69
+
For convenience, you might want to run:
70
+
71
+
`pip install -r requirements.txt`
72
+
73
+
#### Installing python core dependencies on Windows
45
74
You should be able to start the command "pip" by opening a console prompt ("run" -> "cmd.exe") and writing "pip". If not,
46
-
figure out how to run "pip": https://pip.pypa.io/en/stable/ (it should have been installed automatically by python)
75
+
figure out how to run [__pip__](https://pip.pypa.io/en/stable/) (it should have been installed by python automatically):
47
76
48
-
Use "pip" to install dependencies. Running the following command will install all python dependencies:
77
+
Use __pip__ to install dependencies. Running the following command will install all python dependencies:
49
78
50
-
*pip install -r requirements.txt
79
+
`pip install -r requirements.txt`
51
80
52
81
### Installing plugins
53
82
@@ -62,8 +91,10 @@ If you want to use community plugins like the asset downloader - download them,
62
91
63
92
Having done this, you can now start MakeHuman by running the makehuman.py script. On a prompt run
64
93
65
-
* python makehuman.py (on windows)
66
-
* python3 makehuman.py (on debian, ubuntu, mint...)
94
+
* python makehuman.py (on Windows)
95
+
* python3 makehuman.py (on Debian, Ubuntu, Mint...)
96
+
97
+
Alternatively there is a shell script named _makehuman_ to start the application on Linux systems.
67
98
68
99
## Branches
69
100
@@ -77,4 +108,3 @@ Read-only reference branches
77
108
* bitbucket-default: This is the code as it looks in the "default" branch at bitbucket.
78
109
79
110
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.
0 commit comments