Link Search Menu Expand Document

Introduction to conda

This is the documentation associated with the PICScIE Workshop ‘Introduction to Conda’ (Spring 2022).

The full documentation for the course is located here: Documentation

The courses repo is located here Github Repo

Table of contents
  1. Introduction to conda
    1. Workshop goals
    2. Not workshop goals
    3. Requirements
    4. Getting Started
    5. Course Outline
    6. Useful links

The repo is divided into two sections docs/, which are the notes on various conda related topics, and intro2conda, which is a miniscule python package that is used as an example for creating your own conda package.

Workshop goals

Providing you with the tools to make your software reproducible and impart some knowledge to you on how to publish your software using conda

  • Understanding what
    • a package is
    • a package manager is
    • motivates the use of a package manager
  • Some environment knowledge
    • How to create an environment
    • How to work with files describing an environment (environment.yml)
    • Reproduce an environment
  • Some package knowledge
    • How to install packages
    • How to create your own package
    • How to publish your own package

Not workshop goals

  • Make you a Python wizard
  • Teach you how to make a Python Package, even though we are doing it
  • Completely conda-ify all of your software - that would be post-workshop work

Requirements

The main requirement for this course is that you have some notion of how to work with the (Linux) command line, and have a working Anaconda installation.

Getting Started

You technically don’t need anything to get started, but I created a repo with all the docs and a tiny Python package that we will use to create and upload our first conda package. So let’s just clone it for now and then we will get started.

git clone git@github.com:lsawade/introduction-to-conda.git

Then,

cd introduction-to-conda

Course Outline

  1. What is conda?
  2. Environments
  3. Installing Packages
  4. Creating packages
    1. Creating a Python package
    2. Creating a Conda package
  5. What is mamba?
  6. Advanced examples
  7. Cheatsheet

Command line:

Anaconda Installation

  • Install Anaconda: Link

or less storage

  • Install miniconda: Link

Documentation for conda-build and creating conda packages:

YAML Documentation

Cheatsheet for conda

Shameless plug:

  • How to make a python package: Link