Installation Guide
==================

This guide will help you install the `matrice` package and its dependencies.

Requirements
------------
- Python 3.7 or higher
- pip (Python package installer)

Installing Matrice
------------------
To install the latest stable release of `matrice`, use `pip`:

.. code-block:: bash

    pip install matrice

Upgrading Matrice
-----------------
To upgrade to the latest version of `matrice`, run:

.. code-block:: bash

    pip install --upgrade matrice

Verifying the Installation
--------------------------
After installation, you can verify that the package is installed correctly by running:

.. code-block:: python

    import matrice
    print(matrice.__version__)

If the version number is displayed, the installation was successful!

Optional Dependencies
---------------------
`matrice` supports optional dependencies for enhanced functionality. To install them, use:

.. code-block:: bash

    pip install matrice[extras]

Where `extras` can be replaced with one or more of the following:
- `all`: Install all optional dependencies.
- `ml`: For machine learning features.
- `docs`: For generating documentation.