mrkeyoor.com_
Sat 31 Oct 21:53 UTC
LLM Toolsevaluationupdated 20 Oct 2026

airllm review

AirLLM is a Python library whose documented inference approach loads model weights in parts rather than keeping the entire checkpoint in GPU memory. Checkpoint storage and model-specific dependencies remain part of setup. Our sandbox measured package installation and build, without preparing a checkpoint or running generation.

+675stars / 7d
Verdict

AirLLM installed in 74 seconds and built in 4 seconds, but the sandbox supplied no test or generation result. A checkpoint-specific trial is the next step when GPU memory limits your options. Measure preparation, storage use, output correctness, and complete response time before adoption. The audit result does not establish dependency vulnerability coverage.

We ran it

Lab card: what happened when we ran airllmScreenshot of airllm (github.com/lyogavin/airllm)
Install✓ · 74s35 packages · 38 MB
Build✓ · 4s
Testsn/ano test script
Known vulns0(pip-audit)
Repo101 files~9,910 lines of source · 10.8 MB · 2 CI workflows

Answers from our run

Does airllm build from source?

Dependencies installed in 74 seconds (35 packages), and the build succeeded in 4 seconds. We cloned commit cb80751 into a clean Debian container with 3 CPUs and no project-specific setup.

Does airllm have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does airllm have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use airllm?

Mac users expecting the general model list to establish compatibility with the Mac path.

What are the alternatives to airllm?

llama.cpp, Ollama. AirLLM installed in 74 seconds and built in 4 seconds, but the sandbox supplied no test or generation result.

SetupN/AN/A: installation and build completed, but the supplied run did not prepare a checkpoint or execute a supported model. Those missing steps determine much of the setup burden, so the package timings alone do not support a numerical setup rating.
DocsN/AN/A: the supplied README explains inference, cache controls, platform restrictions, and model-specific dependencies. Its examples were not executed, and the supplied extracts do not establish their behavior at tested commit cb80751. A numerical documentation rating would exceed this review's evidence.
CommunityN/AN/A: the supplied release page establishes that v4.0.0 was published, but a release does not establish maintainer response time, issue resolution quality, or support for a particular checkpoint. This review has no support assessment that would justify a numerical community rating.
MaturityN/AN/A: the harness skipped tests because it found no script or target, and model generation and training were not assessed. A successful package build and a published release do not establish model-level correctness or justify a numerical maturity rating.

Discussed on

  1. hnAirLLM 70B inference with single 4GB GPU232 points
  2. hnAirLLM enables 8GB MacBook run 70B LLM79 points

Who it’s for

Python developers evaluating a checkpoint that exceeds their GPU memory and who can manage its model cache.
Researchers able to measure checkpoint preparation and complete generation before adopting a runtime.
Apple Silicon users evaluating one of the Llama-style architectures documented for the Mac path.

Who it’s NOT for

Mac users expecting the general model list to establish compatibility with the Mac path.
Developers without storage for checkpoint weights and layer-split files.
Teams requiring verified generation correctness, response times, or dependency vulnerability coverage from this review.

Setup reality

Our AirLLM run at commit cb80751 installed in 74 seconds, recorded 35 dependencies and 38 MB on disk, and built in 4 seconds on October 14, 2026. Tests were skipped because the harness found no test script or target. The harness recorded zero pip-audit findings, but audit.packages was also zero and no coverage logs were supplied. That result does not establish a completed vulnerability assessment of the recorded dependencies.

The README says the original checkpoint is decomposed and saved layer-wise before inference. It documents layer_shards_saving_path for choosing the split-model directory, delete_original for removing downloaded originals, and hf_token for gated models. These are documentation findings; our sandbox did not execute those options or download a checkpoint. Check access to the selected model and available storage before attempting conversion.

The recorded sandbox configuration specified 3 CPUs and 8 GB RAM. Its image label was ghcr.io/astral-sh/uv:python3.12-bookworm; the label does not verify actual runtime versions. The supplied README limits the Mac path to Apple Silicon with MLX and torch and to Llama-style architectures. Its model-specific dependency requirements also need checking against the chosen checkpoint. Neither the current README nor release v4.0.0 establishes which model paths worked at tested commit cb80751. We did not measure checkpoint preparation, generation, GPU memory use, or training.

A successful install leaves model execution unanswered

AirLLM installed in 74 seconds in our sandbox. Whether your checkpoint produces useful responses within your storage and time limits remains unmeasured.

The Python library's documented approach loads model weights in parts to reduce the amount kept in GPU memory. Its README says the original checkpoint is saved layer by layer before inference. Package installation does not exercise that preparation or establish generation speed. We did not reproduce the project's hardware claims.

This review updates the existing AirLLM assessment. It separates the package results from the checkpoint trial still needed before adoption.

What happened when we ran it

Our run at commit cb80751 installed AirLLM in 74 seconds and built it in 4 seconds on October 14, 2026. Installation recorded 35 dependencies and 38 MB on disk. The checkout contained 101 files, about 9,910 lines of source, and occupied 10.8 MB.

The harness recorded zero pip-audit findings and audit.packages=0. No coverage logs were supplied. The zero-findings entry therefore does not establish that the 35 recorded dependencies received a completed vulnerability assessment.

Tests were skipped because the harness found no test script or target. The scan recorded 2 CI workflow files, no Dockerfile, and no tests directory in that checkout. These observations describe what the harness found; they do not establish that the project has no testing elsewhere.

The recorded sandbox configuration specified 3 CPUs and 8 GB RAM, with image label ghcr.io/astral-sh/uv:python3.12-bookworm. That label does not establish actual runtime or operating-system versions. We did not measure checkpoint preparation, generation, GPU memory use, or training. The 38 MB installed footprint excludes the unmeasured storage needed for a model trial.

Checkpoint preparation needs its own storage plan

The README states: "During inference, the original model will first be decomposed and saved layer-wise." Choose a cache location with room for that preparation before downloading weights.

The supplied quick start passes a model identifier to AutoModel.from_pretrained, tokenizes a prompt, calls generate, and decodes the result. It also accepts a local checkpoint path. These are documentation-only examples; we did not execute the inference calls.

The documented layer_shards_saving_path option chooses where to save the split model. The delete_original option removes downloaded originals while retaining the transformed model. Check whether another application needs those originals before enabling deletion. For gated checkpoints, the README documents hf_token; installing the package does not grant access to the weights.

The README identifies disk loading as the main bottleneck in its explanation of optional weight compression. That is the project's explanation, not a speed measurement from our sandbox. Measure initial preparation separately from later generation and monitor cache growth during both.

Platform and dependency guidance is checkpoint-specific

The supplied README limits the Mac path to Apple Silicon with MLX and torch, and to Llama-style models. It names LlamaForCausalLM and MistralForCausalLM and says other architectures raise an error before downloading. The general support list therefore does not establish Mac compatibility for every listed model.

The README also says Kimi K3 remote code requires Transformers 4.56.x and does not load on 5.x. Flash-Next requires a Transformers build containing the in-tree qwen4_exp implementation. These are documented requirements, not environments exercised in our run. Choose the checkpoint and its dependencies together before assembling an environment.

The supplied README describes current guidance. It is not pinned implementation proof for tested commit cb80751, so this review does not treat its model list or examples as verified behavior of that checkout.

A release is separate from the tested checkout

AirLLM's release page identifies v4.0.0, published September 5, 2026. Our October sandbox used commit cb80751. The package measurements belong to that checkout, not to a separate test of the release tag.

The release establishes publication, without establishing support turnaround or model-level reliability. Product scores remain N/A because checkpoint setup, example correctness, support quality, and generation were not assessed sufficiently for numerical ratings.

Choose an interface, then run a checkpoint trial

llama.cpp documents CPU+GPU hybrid inference. Evaluate it when that execution approach suits the trial you want to run. Ollama has a REST API for running and managing models. Evaluate it when your application needs an existing model-management API. We did not benchmark either alternative.

For AirLLM, select one documented architecture and record the exact checkpoint, AirLLM revision, and dependency versions used in your trial. Track conversion success, storage consumption, output correctness, and complete response time. Compare output with a reference runtime using the same prompt. Those results can support an adoption decision that the package build alone cannot.

Alternatives

ProjectWhat it isPick it when
llama.cpp gh↗A C/C++ inference project that documents CPU+GPU hybrid execution.Evaluate it when CPU+GPU hybrid inference is the execution approach you want to test for your checkpoint.
Ollama gh↗A model runner with a REST API for running and managing models.Evaluate it when your application needs an existing model-management API.

What people are saying

  1. [github-trending] lyogavin/airllm

Sources

  1. AirLLM README, supplied current extract
  2. AirLLM v4.0.0 release
  3. llama.cpp README
  4. Ollama README

More llm tools reviews

ironclaw · infinity · Claude-Code-Game-Studios · OmniRoute · harnessrouter · pi-subagents · the whole board →