============
Installation
============

You can install **iechelle** using one of the following methods depending on your needs.

Via PyPI
--------

The easiest way to install the latest stable version is via ``pip``:

.. code-block:: bash

    pip install iechelle



From Sources
------------

If you want to run the latest version from the repository, clone it and install using **Poetry**:

.. code-block:: bash

    git clone https://github.com/dinilbose/iechelle.git
    cd iechelle
    poetry install

Alternatively, you can use ``pip``:

.. code-block:: bash

    pip install .

Development Setup
-----------------

For developers who want to contribute, we provide a ``Makefile`` to automate the environment setup:

.. code-block:: bash

    # 1. Prepare the environment and git hooks
    make prepare-dev
    source .iechelle

    # 2. Install all core and development dependencies
    make install-dev

Verification
------------

After installation, you can launch the interactive GUI from any terminal by simply typing:

.. code-block:: bash

    iechelle

Alternatively, if you are in the project root, you can use:

.. code-block:: bash

    make run

Or manually via Bokeh:

.. code-block:: bash

    bokeh serve ./iechelle/gui/ --show

The application will open in your default browser at ``http://localhost:5006/gui``.
