openlake README

README проекта с github.com/openlake-project/openlake. Одним файлом markdown: README.md.

OpenLake OpenLake

Fast, easy and efficient storage for LLM Inference and Training

| Blog | Documentation | Comparision | Discord/X | Website |

License Rust Discord Web

🔥 Distributed storage for GPU workloads. Built on Rust on io_uring, OpenLake is a state of the art storage engine delivering million+ iops within 1ms.


Updates

Older updates
  • [2026/07] Introducing OpenLake: open source storage that saturates the GPUs: 8× throughput and 600 µs reads (blog).

Why OpenLake?

OpenLake is a storage engine for AI infrastructure. With OpenLake you get high throughput for small I/O and cache like performance while being fully persistent and durable. Keep GPUs fed during training and inference reducing idle time and getting more from your accelerators.

OpenLake is fast with:

Learn more: Blogs → | Benchmarks → | KV Offload | Object Store


66× speedup on time to first token first token when cached. (128K context window)

GPU nodes contribute to create an OpenLake cluster. The inference engine writes KV once and reads it back in milliseconds (using the host RAM and disk), saving prefill for long and repeated prompts.

Quickstart:

1) Setup KV Pool on GPU nodes:

Drop OpenLake into your existing setup. No code changes:

a. Install the connector and start the store:

pip install openlake-vllm
openlaked

b. Run vLLM with OpenLake enabled:

export PYTHONHASHSEED=0
vllm serve <model_name> --kv-transfer-config '{"kv_connector":"OpenLakeConnector","kv_connector_module_path":"openlake_client.openlake_connector","kv_role":"kv_both","kv_connector_extra_config":{"openlake_nodes":["127.0.0.1:9400"],"openlake_device":"local"}}'

Note: By default OpenLake offloads to the same host. To enable OpenLake across your GPU fleet, please start openlaked with a --config.

For Kubernetes clusters, use the Helm KV deployment guide to place one OpenLake instance on each selected node and generate the ordered vLLM peer configuration.

OpenLake enabled vs disabled:

openlake-video

OpenLake and vLLM serving Gemma4-31B on H100 (256K context window)

Multi host GPU Cluster (IB)

Run OpenLake on existing GPU cluster. Run OpenLake with (kv_rdma.toml) and node's self_id: (0, 1, 2...):

openlaked --config kv_rdma_0.toml   # gpu 1: ids = 0
openlaked --config kv_rdma_1.toml   # gpu 2: ids = 1

Point your vLLM workers at the unified cluster, in id order:

cat > /tmp/openlake-kv.json <<'EOF'
{
  "kv_connector": "OpenLakeConnector",
  "kv_connector_module_path": "openlake_client.openlake_connector",
  "kv_role": "kv_both",
  "kv_connector_extra_config": {
    "openlake_nodes": ["10.0.0.1:9400", "10.0.0.2:9400"],
    "openlake_device": "mlx5_ib0"
  }
}
EOF

export PYTHONHASHSEED=0
vllm serve <model_name> --kv-transfer-config "$(cat /tmp/openlake-kv.json)"

A prefix computed on one GPU host is served to any other from the shared pool.

2) PB scale object store for GPU Fleet

Build from source and have an S3 compatible store running in four steps. Install the dependencies and build the OpenLake binary locally.

a. Clone and build:

sudo apt-get install -y build-essential pkg-config clang cmake libhwloc-dev libudev-dev curl git awscli
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && . "$HOME/.cargo/env"

git clone https://github.com/openlake-project/openlake.git && cd openlake
cargo build --release --bin openlaked

b. Start the store (single node, default config):

mkdir -p data/d0 data/d1 data/d2 data/d3
./target/release/openlaked --config crates/openlake_server/configs/storage-tcp-local.toml
Talk to it with any S3 client:
export AWS_ACCESS_KEY_ID=openlakeadmin
export AWS_SECRET_ACCESS_KEY=openlakeadmin
export AWS_DEFAULT_REGION=us-east-1

aws --endpoint-url http://127.0.0.1:9000 s3 mb s3://demo
aws --endpoint-url http://127.0.0.1:9000 s3 cp ./checkpoint.safetensors s3://demo/
aws --endpoint-url http://127.0.0.1:9000 s3 ls s3://demo/

Both ListObjects versions support encoding-type=url for UTF-8 percent-encoded keys, prefixes, and delimiters in the XML response. Without this option, key names retain their existing XML representation. ListObjectsV2 now echoes StartAfter and returns XML-safe, versioned continuation tokens; treat tokens as opaque and pass them back unchanged, even when changing the encoding option. Legacy raw-key tokens remain accepted except for the reserved openlake-list-v1: token prefix (restart those listings after upgrading).

Build from source:

To build from the source, please follow the platform specific build guides:

Ubuntu / Debian

Produce binaries for your deployment or test code changes.

# Install system dependencies
sudo apt-get update
sudo apt-get install -y --no-install-recommends ca-certificates build-essential pkg-config clang cmake libhwloc-dev libudev-dev curl git

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && . "$HOME/.cargo/env"

# Clone and build OpenLake
git clone https://github.com/openlake-project/openlake.git
cd openlake && cargo build --release --locked -p openlake_server --bin openlaked

# Create the local storage directories
mkdir -p data/d0 data/d1 data/d2 data/d3

# Start OpenLake in TCP mode. Please switch the config path for RDMA.
RUST_LOG=info ./target/release/openlaked --config crates/openlake_server/configs/storage-tcp-local.toml
macOS (development)

Install Homebrew first if brew is unavailable.

# Install system dependencies
xcode-select --install
brew install cmake pkg-config

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && . "$HOME/.cargo/env"

# Clone and build OpenLake
git clone https://github.com/openlake-project/openlake.git
cd openlake && cargo build --release --locked -p openlake_server --bin openlaked

# Create local storage directories
mkdir -p data/d0 data/d1 data/d2 data/d3

# Start OpenLake in TCP mode. (macOS does not provide the Linux RDMA interfaces)
RUST_LOG=info ./target/release/openlaked --config crates/openlake_server/configs/storage-tcp-local.toml
Windows (WSL2)

Build OpenLake with WSL2. See the full Windows development environment guide.


# Run in an administrator PowerShell terminal:
wsl --install -d Ubuntu
wsl

# Then run inside the Ubuntu shell:
# Install system dependencies
sudo apt-get update
sudo apt-get install -y --no-install-recommends ca-certificates build-essential pkg-config clang cmake libhwloc-dev libudev-dev curl git

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && . "$HOME/.cargo/env"

# Clone and build OpenLake
git clone https://github.com/openlake-project/openlake.git
cd openlake && cargo build --release --locked -p openlake_server --bin openlaked

# Create local storage directories
mkdir -p data/d0 data/d1 data/d2 data/d3

# Start OpenLake in TCP mode
RUST_LOG=info ./target/release/openlaked --config crates/openlake_server/configs/storage-tcp-local.toml

If you would like support for a different build system, please open an issue on GitHub.

Architecture

OpenLake keeps the path from storage to GPU memory short, predictable, and low latency.

Explore the architecture and user docs, inspect the included configurations, or read the OpenLake engineering blog for deeper technical discussions.

Contributing

We welcome and value any contributions and collaborations. Please check out Contributing to OpenLake for how to get involved.

Get in touch

License

Apache 2.0.

openlake (openlake-project/openlake)

Ищем в базе…

Что это такое?OpenLake — это движок хранения для инфраструктуры ИИ. Он обеспечивает непрерывную работу GPU во время обучения и инференса: высокая пропускная способность при мелких операциях ввода-вывода и скорость, близкая к кэшу, при полностью постоянном и надёжном хранении данных.
Это кэш или сервер хранения?Это сервер хранения. Он предоставляет хранилище объектов, совместимое с S3, и может служить пулом для KV cache у LLM, но в отличие от обычного кэша данные остаются постоянными и надёжно сохраняются.
Как это запустить?Клонируйте репозиторий, соберите бинарный файл OpenLake из исходников и запустите хранилище с конфигурацией по умолчанию для одного узла. После этого с ним сможет работать любой клиент S3. Для vLLM установите коннектор, запустите хранилище, а затем запустите vLLM с включённым OpenLake.
Что нужно установить перед сборкой?Установите зависимости для сборки, перечисленные в инструкции для вашей платформы: для Ubuntu или Debian, для macOS (для разработки) или для Windows через WSL2. Основной путь ввода-вывода опирается на Linux io_uring.
Есть ли подводные камни при кластерной настройке?По умолчанию OpenLake выгружает данные на тот же хост, поэтому для совместного использования на всём парке GPU нужно запустить openlaked с параметром --config. В Kubernetes используйте инструкцию по развёртыванию Helm KV, чтобы разместить по одному экземпляру на каждом выбранном узле.
На каких операционных системах это собирается?Для Ubuntu и Debian есть отдельная инструкция по сборке, macOS поддерживается для разработки, а Windows работает через WSL2. Сборка под Windows без WSL в README не упоминается.
Нужны ли GPU, чтобы этим пользоваться?Для S3-хранилища нет: оно работает на одном узле с конфигурацией по умолчанию. Выгрузка KV cache для vLLM и функции для кластеров GPU рассчитаны на хосты и парки GPU.
Почему это быстрее обычного хранилища S3?На Linux с io_uring для каждого ядра CPU запускается отдельная закреплённая асинхронная среда выполнения, и ядра не перераспределяют работу между собой. В README также приводятся более миллиона IOPS при задержке до 1 мс и передача данных в память GPU без копирования.
Насколько выгрузка KV cache ускоряет инференс?В README указано ускорение в 66 раз по времени до первого токена, если префикс закэширован, при окне контекста 128K. Выигрыш достигается за счёт повторного использования KV cache вместо пересчёта этапа prefill для повторяющихся запросов.
Сравнивали ли его с чем-то на тестах?В README сказано, что OpenLake занимает первое место в бенчмарке MLPerf Storage v3.0 2026 по сохранению контрольных точек объектов, опережая NVIDIA и Nebius. Относитесь к этим цифрам как к заявлениям автора.
Размер
4.7 MB
Звёзды
3.1K
Возраст
6 мес
Коммиты · 90 дней