conda-spawn

conda-spawn provides a command for running shell commands in activated conda environments without mutating the current shell session.


Licenses
MIT/BSD-3-Clause
Install
conda install -c anaconda conda-spawn

Documentation

conda-spawn

Activate conda environments in new shell processes.

Important

This project is still in early stages of development. Don't use it in production (yet). We do welcome feedback on what the expected behaviour should have been if something doesn't work!

What is this?

conda spawn is a replacement subcommand for the conda activate and conda deactivate workflow

Instead of writing state to your current shell session, conda spawn ENV-NAME will start a new shell with your activated environment. To deactivate, exit the process with Ctrl+D, or run the command exit.

Installation

This is a conda plugin and goes in the base environment:

conda install -n base conda-forge::conda-spawn

More information is available on our documentation.

Supported shells

conda-spawn distinguishes two tiers of shell support:

  • Fully supported: bash, zsh, powershell, cmd. Implemented in conda_spawn.shell. Covered by CI on every push and actively maintained.
  • Best-effort: fish, csh/tcsh, xonsh. Implemented in conda_spawn.contrib. Provided to match conda activate's own activator coverage so conda-spawn can replace it on systems that use those shells. They are lightly tested and we rely on user reports to catch shell-specific bugs.

Contributing

Please refer to CONTRIBUTING.md.