Getting Started using Conda

Getting Started using Conda#

Install Conda (for the first time)#

If you don’t have conda installed yet, fetch the download link from this page, download with wget and execute with all default settings. For example:

# Update the download link with the appropriate version and platform
# this is the same process as the official doc, so you can also follow the official doc for installing conda
wget https://repo.anaconda.com/archive/Anaconda3-<VERSION>-<PLATFORM>.sh
chmod +x Anaconda3-<VERSION>-<PLATFORM>.sh
./Anaconda3-<VERSION>-<PLATFORM>.sh -b

Install environment using Conda#

  1. Clone the MASE repository:

git clone git@github.com:DeepWok/mase.git

  1. Create your own branch to work on:

cd mase
git checkout -b your_branch_name

  1. Install MASE and its dependencies:

# we suggest you to create a new conda environment for MASE, you can do this by running the following command
# this creates separation for safe development and testing
conda create -n mase python=3.11
conda activate mase
# checking , make sure you are using the correct python version and also the correct environment
which python
python --version
# install in editable mode, this means your changes will be reflected in the package
# we suggest you use -m install instead of plain pip install to avoid any misuse
python3 -m pip install -e . -vvv

Common error: when installing the pip requirements, make sure the conda environment is activated and the pip command points to your environment version. You can check this by running which pip or which python and making sure the resulting path includes “anaconda” and “mase”.

Detailed explanation and test your installation#

  1. After all dependencies are installed, you can do an editable pip install. This is the last line of the previous code snippet. If you have executed the above code snippet, YOU DO NOT NEED TO RUN THIS COMMAND AGAIN. However, it is worse to learn what is editable install. This makes the mase packages available within any python session in your environment, this command was included in the previous step. You have to understand what is meant by editable mode. This means that the package is installed in a way that any changes you make to the source code will be reflected in the package. This is useful for development and testing purposes. For stable installations, you can remove the -e flag.

python3 -m pip install -e . -vvv

  1. (Optional but suggested) You can check the installation was successful by running the following, which ensures MASE’s software stack is available globally in your python environment.

python -c "import chop"

  1. (Optional but suggested) You can also run the Machop test stack to ensure the codebase is running correctly by running the following command.

pytest machop/test