CheatPress

conda Package and env manager

Version 26.9.0 · source

conda, Postcard, light preview Light · Postcard 102 × 152 mm · PDF conda, Postcard, dark preview Dark · Postcard 102 × 152 mm · PDF conda, Postcard, ink saver preview Ink saver · Postcard 102 × 152 mm · PDF
conda, A5, light preview Light · A5 148 × 210 mm · PDF conda, A5, dark preview Dark · A5 148 × 210 mm · PDF conda, A5, ink saver preview Ink saver · A5 148 × 210 mm · PDF
conda, A4, light preview Light · A4 210 × 297 mm · PDF conda, A4, dark preview Dark · A4 210 × 297 mm · PDF conda, A4, ink saver preview Ink saver · A4 210 × 297 mm · PDF
conda, A4 landscape, light preview Light · A4 landscape 297 × 210 mm · PDF conda, A4 landscape, dark preview Dark · A4 landscape 297 × 210 mm · PDF conda, A4 landscape, ink saver preview Ink saver · A4 landscape 297 × 210 mm · PDF
conda, A3, light preview Light · A3 297 × 420 mm · PDF conda, A3, dark preview Dark · A3 297 × 420 mm · PDF conda, A3, ink saver preview Ink saver · A3 297 × 420 mm · PDF
conda, A3 landscape, light preview Light · A3 landscape 420 × 297 mm · PDF conda, A3 landscape, dark preview Dark · A3 landscape 420 × 297 mm · PDF conda, A3 landscape, ink saver preview Ink saver · A3 landscape 420 × 297 mm · PDF
conda, Letter, light preview Light · Letter 8.5 × 11 in · PDF conda, Letter, dark preview Dark · Letter 8.5 × 11 in · PDF conda, Letter, ink saver preview Ink saver · Letter 8.5 × 11 in · PDF
conda, Tabloid, light preview Light · Tabloid 11 × 17 in · PDF conda, Tabloid, dark preview Dark · Tabloid 11 × 17 in · PDF conda, Tabloid, ink saver preview Ink saver · Tabloid 11 × 17 in · PDF

Start here

conda create -n <env> python=3.12
New environment
conda activate <env>
Switch into it
conda install <package>
Add a package
conda list
What is installed?
conda env list
All environments
conda env export > environment.yml
Share the setup
conda env create -f environment.yml
Rebuild from file
conda deactivate
Leave the environment

Concepts

  1. Channels defaults, conda-forge
  2. Package cache pkgs/
  3. Environment envs/<name>
  4. Shell PATH set

Environments

conda create -n <env> <package>...
Create a named environment
conda create -p <path> <package>...
Create at a path instead of by name
conda activate <env>
Activate an environment
conda deactivate
Deactivate the current one
conda env list
List all environments
conda env remove -n <env>
Delete an environment
conda create -n <new> --clone <env>
Copy an environment
conda rename -n <env> <new>
Rename an environment
conda info
Show conda setup and active env
conda init <shell>
Hook conda into a shell profile
Restart the shell afterwards; conda config --set auto_activate_base false keeps base off.
conda run -n <env> <command>
Run a command without activating
Add --no-capture-output to stream output live.

Packages

conda install <package>
Install into the active env
conda install <package>=<version>
Install a given version
conda install -n <env> <package>
Install into another env
conda install -c <channel> <package>
Install from a channel
conda update <package>
Update one package
conda update --all
Update everything
conda remove <package>
Uninstall a package
conda list
List installed packages
conda list <regex>
Filter the installed list
conda search <package>
Find available versions
conda search -c <channel> <package>
Search one channel
conda install --dry-run <package>
Preview without changing
conda install --file <file>
Install specs from a text file
conda install --revision <n>
Roll back to a revision
conda list --revisions
Show environment history

Channels and config

conda config --add channels conda-forge
Add a channel (highest priority)
conda config --set channel_priority strict
Prefer higher channels strictly
conda config --show channels
Show configured channels
conda config --show-sources
Show config files in use
conda config --show
Show effective settings
conda config --get <key>
Read one setting
conda config --set <key> <value>
Set a setting
conda config --append channels <channel>
Add a channel at lowest priority
conda config --remove channels <channel>
Remove a channel
conda config --set auto_activate_base false
Do not activate base at startup
conda install -c <channel> --override-channels <package>
Use only this channel

Sharing environments

conda env export > environment.yml
Export the active env
conda env export --from-history
Export only what you asked for
Portable across platforms; leaves out transitive pins.
conda env export --no-builds
Drop build strings
conda env create -f environment.yml
Create from a file
conda env update -f environment.yml --prune
Sync env to the file
conda export --format environment-yaml
Export in a chosen format
conda list --explicit > spec-file.txt
Exact URLs for reproducible builds
conda create -n <env> --file spec-file.txt
Rebuild from an explicit list
conda env create -n <env> -f environment.yml
Override the name in the file
environment.yml
name: myenvchannels:  - conda-forgedependencies:  - python=3.12  - numpy  - pip:    - requests

Cleanup and diagnostics

conda clean --all
Remove caches and unused packages
conda clean --packages
Remove unused packages
conda doctor
Check environment health
conda --version
Print the conda version
conda update -n base conda
Update conda itself

Recipes

Reproducible project environment
conda create -n proj -c conda-forge python=3.12 numpyconda activate projconda env export --from-history > environment.ymlgit add environment.yml
Recreate an environment on another machine 
conda env create -f environment.ymlconda activate projconda list
Try a change safely, then roll back
conda install --dry-run <package>conda install <package>conda list --revisionsconda install --revision <n>
Free disk space
conda clean --dry-run --allconda clean --allconda env listconda env remove -n <old-env>