Installation
============
Use a **Python 3.7** environment for development.

Creating environment with Conda (example)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Having a Conda distribution (i.e. Anacoda, Minicoda etc) create environment like::

    conda create --name pyalcs python=3.7

Then activate it with::

    source activate pyalcs

Dependencies
^^^^^^^^^^^^
You should be fine with::

    pip install -r requirements.txt
    pip install -r requirements-integrations.txt --upgrade

In case of troubles see ``Dockerfile`` and ``.travis.yml`` how the project is built from scratch.

Launching example integrations
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
I assuming you are inside the virtual environment created before. In order to run the integrations from the console you need to specify Python PATH to use the currently checked-out version of ``pyalcs`` library::

    PYTHONPATH=<PATH_TO_MODULE> python examples/acs2/maze/acs2_in_maze.py

Interactive notebooks
^^^^^^^^^^^^^^^^^^^^^
Start the Jupyter notebook locally with::

  make notebook

Open the browser at ``localhost:8888`` and examine files inside ``notebooks/`` directory.

You might also want to install some extensions::

  jupyter labextension install @jupyter-widgets/jupyterlab-manager
  jupyter contrib nbextension install