# Installation

This guide walks you through the installation process for the ConversionFlow library.

## Prerequisites

Before installing ConversionFlow, ensure you have the following prerequisites:

- Python 3.8 or higher
- pip package manager
- Git (for cloning the repository)

## Installation Steps

1. **Clone the Repository**

   ```bash
   git clone https://github.com/Msix-DS/ConversionFlow.git
   cd ConversionFlow
   ```

2. **Set Up a Virtual Environment (Recommended)**

   ```bash
   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   ```

3. **Install Dependencies**

   ```bash
   pip install -r requirements.txt
   ```

4. **Verify Installation**

   To verify that ConversionFlow is installed correctly, run:

   ```bash
   python -m conversionflow.verify_installation
   ```

## Configuration

After installation, you need to set up the configuration file. Create a copy of the example configuration file:

```bash
cp config.example.yml config.yml
```

Edit `config.yml` to match your specific requirements. See the [Configuration Reference](../reference/configuration.md) for details on available options.

## Next Steps

Now that you have installed the ConversionFlow library, you can proceed to the [Basic Usage](basic_usage.md) tutorial to learn how to use the library.