Installation

pip install "ray[serve,haproxy]"

Or directly:

pip install ray-haproxy

Platform support

• Linux x86_64 (manylinux_2_17_x86_64)

• Linux arm64 (manylinux_2_17_aarch64)

Usage

from ray_haproxy import get_haproxy_binary
print(get_haproxy_binary())  # /path/to/ray_haproxy/bin/haproxy

Binary resolution order:

1. RAY_SERVE_HAPROXY_BINARY environment variable (explicit override)

2. Bundled binary inside this package

3. haproxy on the system PATH

Vendored shared libraries

The wheel bundles HAProxy and the shared libraries it depends on that are not guaranteed to exist on all Linux systems. At build time, the script ci/build/build-haproxy-dist.sh compiles HAProxy inside a manylinux2014 container, then uses ldd to discover every .so the binary needs. Libraries on the PEP 599 manylinux2014 allowlist (libc, libz, libpthread, etc.) are skipped — they are guaranteed present on any compatible system. Everything else is copied into lib/ and the binary’s RPATH is patched to $ORIGIN/lib so it finds its vendored copies at runtime.

Libraries not vendored (on the PEP 599 allowlist): libc, libm, libdl, librt, libpthread, libz, libgcc_s, libresolv, libcrypt.so.1.

License

HAProxy is distributed under the GNU General Public License v2. See LICENSE for details.