Skip to content

Installing climakitae (1.2.3) locally using conda environment

Jump to bottom
Eric Lehmer edited this page Apr 2, 2025 · 1 revision

Installing climakitae (1.2.3) locally using conda environment

climakitae is primarily designed to be run in a pangeo-notebook docker image implementation of JupyterHub. The JupyterHub allows for cloud computing and user interfaces within a Jupyter Notebook. The base climakitae package functionality is also useful outside of this environment so there is motivation to understand how to install climakitae locally.

Anaconda is the best python environment to install climakitae locally, although climakitae can be pip installed on Ubuntu (or other Unix variants) if you create a python virtual environment that uses python 3.12.7. More than likely you will have to compile python 3.12.7 from source and then use that as a basis for the virtual environment.

If you want to install the climakitaegui package that contains the GUI tools for use with climakitae do these steps: https://github.com/cal-adapt/climakitaegui/wiki/Installing-climakitaegui-(1.2.3)-locally-using-conda-environment

Ubuntu installation steps

  1. Install miniconda3: https://docs.anaconda.com/miniconda/
  2. Download the conda lockfile from the cae-environments repo: https://github.com/cal-adapt/cae-environments/blob/main/conda-lock/climakitae/1.2.3/conda-linux-64.lock
  3. Run: conda create -n climakitae --file conda-linux-64.lock (either in the directory with the lockfile or change the path to where it is on your system)
  4. Run: conda activate climakitae
  5. Run: pip install https://github.com/cal-adapt/climakitae/archive/refs/tags/1.2.3.zip

Windows installation steps

  1. Install Anaconda on your system: https://www.anaconda.com/
  2. Download the conda lockfile from the cae-environments repo: https://github.com/cal-adapt/cae-environments/blob/main/conda-lock/climakitae/1.2.3/conda-win-64.lock
  3. Open Anaconda terminal
  4. Run: conda create -n climakitae --file conda-win-64.lock (either in the directory with the lockfile or change the path to where it is on your system)
  5. Run: conda activate climakitae
  6. Run: pip install https://github.com/cal-adapt/climakitae/archive/refs/tags/1.2.3.zip

MacOS installation steps

  1. Install Anaconda on your system: https://www.anaconda.com/
  2. Download the conda lockfile from the cae-environments repo: ARM64: https://github.com/cal-adapt/cae-environments/blob/main/conda-lock/climakitae/1.2.3/conda-osx-arm64.lock Intel: https://github.com/cal-adapt/cae-environments/blob/main/conda-lock/climakitae/1.2.3/conda-osx-64.lock
  3. Open Anaconda terminal
  4. Run: conda create -n climakitae --file conda-osx-arm64.lock or conda create -n climakitae --file conda-osx-64.lock (either in the directory with the lockfile or change the path to where it is on your system)
  5. Run: conda activate climakitae
  6. Run: pip install https://github.com/cal-adapt/climakitae/archive/refs/tags/1.2.3.zip

Clone this wiki locally