Enthought Deployment Manager
============================

Enthought Deployment Manager (EDM) is Enthought's Python environment and 
application manager.  EDM's main features are:

* Create multiple **self-contained Python environments**.
* Environments are **fully reproducible, including the Python runtime**, using
  the "bundle" lockfile feature.
* Apply a **fast, state-of-the-art SAT solver** with support for conflicts,
  provides, and other features available in advanced package managers.
* Supports hundreds of **Enthought binary packages, including AI/ML libraries with GPU support**,
  across Linux, MacOS and Windows.


Examples
--------

A basic workflow looks as follows:

    .. code-block:: bash

     # will install scipy in your default environment
     $ edm install scipy
     # starts a new shell in the default environment
     $ edm shell
     (edm) $ python -c "import scipy"
     $ exit # exit the shell
     # If you prefer virtualenv-like activation
     $ source edm-activate
     (edm) $ python -c "import scipy"
     $ deactivate

Multiple environments may be created through the `-e/--environment` option:

    .. code-block:: bash

     $ edm install "scipy < 0.17" -e test-old-scipy
     $ edm shell -e test-old-scipy
     # or using virtualenv-like activation
     $ source edm-activate test-old-scipy

To install an alternative runtime (experimental, not available on every
platform):

    .. code-block:: bash

     # Create a minimal pypy environment w/ pypy interpreter
     $ edm environments create test-pypi --implementation pypy
     # Create a minimal julia environment
     $ edm environments create test-julia --implementation julia
     # To list available runtimes:
     $ edm available-runtimes

The basic command line is documented in the :doc:`quick usage guide
<user/cli>`.

Next Steps
----------

* Follow the :doc:`install guide <installation>` to install EDM on your
  computer.
* Consult the :doc:`command line reference <user/cli>` to learn how to use
  EDM.

.. toctree::
   installation
   user/cli
   user/tips_and_tricks
   user/locking
   dev/history
   :maxdepth: 1
   :hidden: