# Installation

The recommended way to install **PyFasma** is by using [Conda](https://www.anaconda.com/docs/getting-started/miniconda/main) to manage the Python environment. [Poetry](https://python-poetry.org/) is used for dependency management and packaging. An alternative Poetry-only method is also available.

## Conda + Poetry (Recommended)

1. Download and [install Miniconda](https://www.anaconda.com/docs/getting-started/miniconda/install) if you do not already have Conda installed.

1. Create and activate a Conda environment:

   ```bash
   conda create -n pyfasma python=3.12
   conda activate pyfasma
   ```

1. Install Poetry inside the environment:

   ```bash
   pip install poetry
   ```

1. Clone the PyFasma repository:

   ```bash
   git clone https://gitlab.com/lepa22/pyfasma.git
   cd pyfasma
   ```

1. Configure Poetry to use the Conda environment:

   ```bash
   poetry config virtualenvs.create false --local
   ```

1. Install the package and dependencies:

   ```bash
   poetry install
   ```

1. (Optional) Install extras (e.g., Jupyter, Excel support):

   ```bash
   poetry install --extras "extras"
   ```

---

## Poetry-only (Alternative)

This method creates and manages a virtual environment automatically, scoped to the project directory.

1. Install Poetry:

   ```bash
   curl -sSL https://install.python-poetry.org | python3 -
   ```

1. Clone the PyFasma repository:

   ```bash
   git clone https://gitlab.com/lepa22/pyfasma.git
   cd pyfasma
   ```

1. Install the package and dependencies:

   ```bash
   poetry install
   ```

1. Activate the virtual environment:

   ```bash
   poetry shell
   ```

1. (Optional) Install extras:

   ```bash
   poetry install --extras "extras"
   ```

:::{note}
When using the Poetry-only installation, all Poetry commands (e.g., `poetry shell`, `poetry run python`) must be executed **from within the project directory** (where `pyproject.toml` is located).  
Poetry environments are tied to the project, unlike Conda environments which can be activated globally.
:::