Difference between revisions of "Conda"
Moskalenko (talk | contribs) |
Moskalenko (talk | contribs) |
||
Line 122: | Line 122: | ||
See the [[{{PAGENAME}}_Install]] page for {{#var: app}} installation notes.|}} | See the [[{{PAGENAME}}_Install]] page for {{#var: app}} installation notes.|}} | ||
<!--Turn the Table of Contents and Edit paragraph links ON/OFF--> | <!--Turn the Table of Contents and Edit paragraph links ON/OFF--> | ||
− | + | __NOEDITSECTION__ |
Revision as of 21:46, 26 August 2021
Description
Conda is an open-source package management system and environment management system that runs on Windows, macOS, and Linux. Conda quickly installs, runs, and updates packages and their dependencies. Conda easily creates, saves, loads, and switches between environments. Separating applications in separate conda environments allows installation of incompatible dependencies - python2 and python3 for example.
Note: For a faster conda see Mamba.
Environment Modules
Run module spider conda
to find out what environment modules are available for this application.
System Variables
- HPC_CONDA_DIR - installation directory
- HPC_CONDA_BIN - executable directory
Configuration
Note: If you are an active conda user conda package cache can quickly fill up your home directory. We recommend changing the pkgs_dirs
setting in ~/.condarc to point to another filesystem e.g.
pkgs_dirs: - /blue/gators/albert/conda/pkgs
Here is an example ~/.condarc. Change 'GROUP' to the name of your group or type the exact path.
channels: - conda-forge - bioconda - defaults envs_dirs: - /blue/GROUP/${USER}/conda/envs pkgs_dirs: - /blue/GROUP/${USER}/conda/pkgs auto_activate_base: false auto_update_conda: false always_yes: False show_channel_urls: True
Additional Information
UF Research Computing Applications Team uses conda for many application installs behind the scenes. We are happy to install applications on request for you. However, if you would like to use conda to create multiple environments for your personal projects we encourage you to do so. Here are some recommendations for successful conda use on HiPerGator.
- We suggest not installing your own copy of miniconda or anaconda, but using one of our conda or mamba environment modules (
module load conda
) to get the 'conda engine' for free. A personal miniconda3 install will overwrite your ~/.bashrc into your ~/.conda/envs directory, which could fill up your home_quota very fast.
We would like to suggest using '-p' argument to create environments by 'path', so they wouldn't fill up your home directory (check quota with home_quota) and could be located conveniently close to the project(s) they serve in /blue for better tracking of installs
Use
conda create -yp /path/to/the/environment
command instead of 'conda create -n name_of_the_env'
The above has the advantage over the default conda behavior of creating envs by name in your home directory that you can create an environment in blue and not run the risk of filling up your home_quota. It's also much easier to keep track of the many environments if they are located closer to the projects they serve rather than being dumped into ~/.conda/envs as conda usually does by default. Note, as described in
- We would like to point out that there is a clear distinction between using conda environments to install packages and using applications installed in those environments. To use a conda environment you need to add its 'bin' directory to your shell $PATH whether in an interactive session or a job script submitted to the scheduler. To modify a conda environment by installing or removing packages you need to 'activate' the environment. Because of that distinction we strongly recommend against allowing miniconda to insert its activation code into your shell initialization file ~/.bashrc. If you already let it do so please remove the offending code from ~/.bashrc. It's the text within and including the
# >>> conda initialize >>> ... # <<< conda initialize <<<
lines.
Instead, load our conda environment module, which we keep up-to-date with conda releases any time you need to create conda environments and to install packages in them. The difference is that 'conda activate' command will not be available, so you will have to use 'source activate' command instead.
E.g.
$ module load conda $ conda activate /path/to/the/environment
Once you are done installing packages inside the environment you can use
$ conda deactivate
We do not recommend activating conda environments when _using_ them i.e. running programs installed in the environments. Please prepend the path to that environment to your $PATH instead.
E.g. If you have a project-specific conda environment at '/home/myuser/envs/project1/' add the following into your job script before executing any commands
export PATH=/home/myuser/envs/project1/bin:$PATH