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

This guide covers the installation of SpecAlign on various platforms.

Requirements
------------

- Python 3.9 or higher
- pip package manager
- OpenAI API key (or compatible provider)

Installation Methods
--------------------

From PyPI (Recommended)
~~~~~~~~~~~~~~~~~~~~~~~

.. code-block:: bash

   pip install specalign

From Git Repository
~~~~~~~~~~~~~~~~~~~

.. code-block:: bash

   pip install git+https://github.com/your-org/specalign.git

For Development
~~~~~~~~~~~~~~~

.. code-block:: bash

   git clone https://github.com/your-org/specalign.git
   cd specalign
   pip install -e ".[dev]"

Verify Installation
-------------------

After installation, verify that SpecAlign is correctly installed:

.. code-block:: bash

   specalign --version

You should see output similar to:

.. code-block:: text

   SpecAlign version 1.0.0

Dependencies
------------

SpecAlign depends on the following packages:

.. list-table::
   :header-rows: 1
   :widths: 30 70

   * - Package
     - Purpose
   * - ``typer``
     - CLI framework
   * - ``openai``
     - OpenAI API client
   * - ``pydantic``
     - Data validation
   * - ``rich``
     - Terminal formatting
   * - ``numpy``
     - Numerical operations
   * - ``httpx``
     - HTTP client

Next Steps
----------

- :doc:`quickstart` - Get started with your first run
- :doc:`first_experiment` - Run your first red-team experiment