Implementation:Ray project Ray Compile Pip Dependencies

Knowledge Sources	Ray pip-tools
Domains	Build_Systems, Dependency_Management
Last Updated	2026-02-13 17:00 GMT

Overview

External tool documentation for the compile_pip_dependencies() bash function that produces the Ray project's Python dependency lockfile.

Description

The compile_pip_dependencies() function in ci/ci.sh gathers ~13 requirements files, installs numpy and torch for context, runs pip-compile (from pip-tools v7.4.1) to resolve all transitive dependencies, and post-processes the result to remove local installs and CPU-only torch suffixes. The output is python/requirements_compiled.txt. The function skips on aarch64 architecture.

Usage

Run as part of the CI pipeline. Not typically invoked directly by developers.

Code Reference

Source Location

• Repository: ray-project/ray
• File: ci/ci.sh
• Lines: L16-80

Signature

compile_pip_dependencies()

Import

source ci/ci.sh

I/O Contract

Inputs

Name	Type	Required	Description
requirements files	.txt files	Yes	~13 requirements files from python/requirements.txt, python/requirements/ml/*.txt, etc.
numpy, torch	pip packages	Yes	Pre-installed for resolution context

Outputs

Name	Type	Description
requirements_compiled.txt	File	Fully-pinned lockfile at python/requirements_compiled.txt

Usage Examples

CI Invocation

# From CI pipeline
source ci/ci.sh
compile_pip_dependencies

Related Pages

Implements Principle

• Principle:Ray_project_Ray_Dependency_Compilation

Requires Environment

• Environment:Ray_project_Ray_CI_Build_Matrix_Environment