Skip to main content

Installation

Horus is distributed as the horus-runtime Python package. It ships the horus command-line tool you use to run workflows.

Requirements​

Python 3.13 or newer. Check your version:

python --version

Install​

With pip:

pip install horus-runtime

Or with uv:

uv pip install horus-runtime

It is a good idea to install into a virtual environment so Horus and its dependencies stay separate from the rest of your system:

python -m venv .venv
source .venv/bin/activate      # Windows: .venv\Scripts\activate
pip install horus-runtime

Verify​

horus --version

Running horus with no arguments prints the available commands:

horus
Usage: horus [OPTIONS] COMMAND [ARGS]...

  Run workflows and tasks using the Horus Runtime.

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  run  Run the workflow defined in WORKFLOW_YAML.

Next steps​

Head to the Quickstart to run your first workflow, or read Core concepts for the ideas behind it.