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

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

- Python >= 3.11
- The ``ws3`` and ``highspy`` packages (PyPI; installed by default)

Editable install::

   pip install -e ".[dev]"

Verification::

   fresh-fuchs --help
   python -m pytest

Bundle builds (Phase 1)
-----------------------

Building the ws3 model from a real femic bundle requires the ``bundle``
extra, which pulls ``femic`` (pinned to the PyPI alpha ``0.2.0a1``) and
``geopandas``::

   pip install -e ".[dev,bundle]"

A local femic source checkout can be used instead (for example during
development alongside the femic repo)::

   pip install --no-deps -e /path/to/femic

Orchestration (Phase 5)
-----------------------

The freshforge workflow/matrix orchestration (``fresh_fuchs.orchestration``)
requires the ``orchestration`` extra, which pulls ``freshforge`` (pinned to
the PyPI alpha ``0.1.0a6``, the first release with the evidence-manifest
API)::

   pip install -e ".[dev,orchestration]"

The ``dev`` extra already includes ``freshforge``, so the full test suite
(including the orchestration tests) runs in CI. Without freshforge, the core
package and the rest of the test suite still run — the orchestration tests
guard with ``pytest.importorskip``. A local source checkout can be used
instead::

   pip install --no-deps -e /path/to/freshforge

Other external source dependencies
----------------------------------

``nemora`` — distribution fit and sampling — is an optional stochastic-driver
basis and is not yet on PyPI (expected as a local source checkout whose path
comes from configuration). The v0.1.0a1 scenario engine uses a built-in
Gaussian/fixed distribution registry, so nemora is not required for the
default pipeline.