Skip to content

v0.2.0

Choose a tag to compare

View all tags
@andreygrehov andreygrehov released this 28 Sep 21:05
v0.2.0
31962d5

Range now opens container images and Hugging Face repositories as they are, with no pull and no conversion.

range shell python:3.12
range run ghcr.io/ggml-org/llama.cpp:light-b11206 --mount hf://unsloth/gemma-3-270m-it-GGUF:/model -- \
  llama-cli -m /model/gemma-3-270m-it-Q4_K_M.gguf -st -p "Why is the sky blue?"
range run python:3.12 --mount hf://moonshotai/Kimi-K2-Instruct:/model -- du -sh --apparent-size /model

New:

  • Container images by name (python:3.12, ghcr.io/org/app:tag, docker://, oci://). The first run of an image reads each layer once to index it. Later runs read only what the command touches, checked per 64 KiB. gzip, zstd and zstd:chunked layers.
  • hf://org/name[@revision]: a Hugging Face repository as a read-only filesystem, pinned to one commit.
  • --mount URI:/path for range shell and range run, on Linux and on macOS.
  • range mount <uri> <dir> on Linux.
  • range run <image> with no command runs the image's own entrypoint and cmd.

Measurements are in docs/BENCHMARKS.md.

Install on macOS or Linux, x86-64 or arm64:

curl -fsSL https://github.com/andreygrehov/range/releases/latest/download/range_$(uname -s)_$(uname -m).tar.gz | tar -xz
./range doctor

On macOS, also brew install lima, and keep range-linux-<arch> next to range. Check the archives against SHA256SUMS.

Assets 7
Loading