Installation

greyhound requires Python >= 3.11, PyTorch >= 2.7.1, and a CUDA-capable GPU.

Installing with pip

greyhound-kernels is available on PyPI. It provides the greyhound Python import package:

pip install greyhound-kernels

Or with uv:

uv add greyhound-kernels

Installing from source

Clone the repository:

git clone https://github.com/tyler-romero/greyhound.git
cd greyhound

Then install in editable mode with development dependencies:

uv

uv sync --all-extras

pip

pip install -e ".[dev]"

Optional dependencies

For the Quack dependency used by bonus Newton-Schulz utilities and Quack comparison benchmarks:

uv

uv sync --extra quack

pip

pip install -e ".[quack]"

For the full benchmark provider set:

uv sync --extra dev --group thirdparty

This uv-only dependency group installs comparison providers used by benchmark scripts, such as Dion, liger-kernel, gram-newton-schulz, flash-linear-attention, and causal-conv1d. The group is intentionally not published as a Greyhound package extra because PyPI rejects direct Git dependencies in uploaded package metadata.

For Modal benchmark execution:

uv

uv sync --extra modal

pip

pip install -e ".[modal]"