Installation Guide
Prerequisites
You need to have a working Python 3 environment on your system. The recommended way to get a Python 3 installation is using Miniconda (minimal installation, very small download) or Anaconda (comes with many packages pre-installed, so a much larger ~3GB download: but a bit more beginner-friendly to install). See the respective pages for more information.
Anaconda: https://www.anaconda.com
Miniconda: https://docs.conda.io/en/latest/miniconda.html
Some documentation on Anaconda vs Miniconda: https://docs.conda.io/projects/conda/en/latest/user-guide/install/download.html#anaconda-or-miniconda
Note
If you are comfortable working with Conda environments, we recommend creating a new environment for PyDaddy, but this is not strictly necessary. For more information about environments, see: https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html)
If you are installing the development version (see below), also ensure that you have Git installed on your system. You can do this using the following command:
git --version
(If Git is already installed, this should show the version number; otherwise, it will show an error message saying git is not found.)
If Git is not installed, download and install it from https://git-scm.com
Note
On macOS/Linux, the following commands needs to be entered in the Terminal. On a Windows machine with Anaconda/Miniconda, these need to be entered into the ‘Anaconda Terminal’ app.
Installation using pip
Once Python 3 is set up, the latest release version can be installed using the following command:
pip install pydaddy
To install the latest development version of PyDaddy directly from the GitHub repo, use:
pip install git+https://github.com/tee-lab/PyDaddy.git
Installation using conda
The release version of PyDaddy can also be installed using conda as follows:
conda install -c tee-lab pydaddy
Verifying installation
To verify that everything is installed and working correctly, close and reopen the Terminal (Anaconda Terminal if you are using Windows) and try the following. First open an IPython terminal as follows:
ipython
Within IPython, type the following:
import pydaddy
If the installation was sucessful, the import command should work and throw no errors. Now type
pydaddy.__version__
This should print the current version number of PyDaddy.
Congratulations, you have now successfully installed PyDaddy!