Installation¶

Aegir is built with pixi. Two use cases:

Just running the framework¶

If you only need to run workflows (e.g. update .jsonnet files, drive existing simulations), consume the pre-built aegir package from the prefix.dev/ship-experiment/stable channel:

pixi init my-aegir-workspace
cd my-aegir-workspace
pixi workspace channel add https://prefix.dev/ship-experiment/stable
pixi add aegir
pixi run phlex -c <path-to-workflow>.jsonnet

The package installs its example workflows under $CONDA_PREFIX/share/aegir/workflows/. Copy one into your workspace as a starting point, together with lib.libsonnet, which most of them import.

Building from source¶

For changes to the C++ code, clone and build:

git clone https://github.com/ShipSoft/aegir.git
cd aegir
pixi run build

pixi run build depends on configure, so a fresh checkout becomes a ready-to-run environment in one command. See the aegir README for the full list of tasks (test, smoke, clean, …) and the pixi shell vs pixi run workflow.