一个可重复的本地基准测试框架,用于在 Apple Silicon 上比较 Laguna S 2.1 的各种 MLX 量化版本,记录 token 吞吐量、内存使用以及生成和智能体编码任务得分。

Stars

150

7 天增长

+4

Fork 数

2

开放 Issue

0

开源协议

MIT

最近更新

2026-07-22

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

提供了对 Apple Silicon 上多种量化 Laguna S 2.1 变体的全面、可复现的比较,包含 token 吞吐量、峰值 MLX 内存、任务得分等详细指标,以及长上下文检索测试和针对不同内存预算的量化阶梯。

适合谁使用

  • 在 Apple Silicon 上评估本地 LLM 性能的 MLX 用户
  • 为编码任务选择最佳速度与质量折衷的量化方案的开发者
  • 在不同 Apple Silicon 配置下研究模型效率的研究人员
  • 在内存受限环境下运行本地 LLM 推理的 macOS 高级用户

典型使用场景

  • 在给定 Mac 上比较同模型的不同量化方法(如 2-bit vs 4-bit)
  • 识别通过所有质量断言且对编码工作负载最快可用的量化版本
  • 在新 Apple Silicon 机器上复现基准结果以指导部署决策
  • 从其他 Mac 贡献社区结果,合并到统一 CSV 中进行更广泛比较

项目优势

  • 综合指标:包含 token 吞吐量、预填充速度、峰值 MLX 内存、加载时间以及生成和智能体编码任务得分
  • 可复现:固定模型版本、确定性解码设置、通过 uv 锁定环境
  • 支持多种引擎(MLX-LM、mlx-vlm、OpenAI 兼容服务器),并为不同 RAM 预算提供量化阶梯
  • 开放社区贡献,支持自动 CSV 合并,并提供清晰的贡献指南

使用前须知

  • 由于 MLX 依赖,仅能在 Apple Silicon(M系列)硬件上运行
  • 部分量化变体需要捆绑的自定义加载器(例如 pipenetwork 的 MLX-LM 加载器),而非标准 mlx-vlm
  • 结果与机器相关,可能随 macOS 更新、Metal 内核版本或运行时版本而变化

README 快速开始

Laguna S 2.1 MLX benchmark

This repository contains a reproducible local harness for comparing Laguna S 2.1 MLX quantizations on Apple Silicon. Each run records the raw output and task score along with token and prefill throughput, peak MLX memory, load time, package versions, model revision, and machine metadata.

This work was sponsored by DWS LLC.

The new leader on the M5 Max is pipenetwork/Laguna-S-2.1-MLX-2bit through MLX-LM. It passed all 38 assertions, averaged 63.86 generation tok/s across the three generation tasks, and reached 68.49 tok/s in the fixed 256-token decode. It needs the conversion's bundled Laguna loader, so the harness loads that file from a pinned revision without modifying the installed MLX-LM package. The measurements are in BENCHMARK_RESULTS.md.

Results at a glance

These results were measured on a 128 GB Apple M5 Max using macOS 27.0, Python 3.13.12, MLX 0.32.0, mlx-vlm 0.6.6, and MLX-LM 0.31.3. The score combines three generation tasks and three agentic coding tasks. Throughput is weighted across the generation tasks.

The left panel reproduces the Terminal-Bench 2.1 figures in Poolside's model card. The right panel comes from this repository's committed CSV and selects the frontier plus one useful representative from each quant/runtime family; the table and CSV below contain every measured variant. The panels use separate scales and are not the same evaluation. Regenerate the SVG with:

uv run --frozen laguna-bench chart

Rows are sorted by overall score, then weighted generation throughput.

QuantOverall scoreGenerationAgenticGeneration tok/sPeak GBSuite time
pipenetwork/Laguna-S-2.1-MLX-2bit1.0001.0001.00063.8639.3187.47s
mlx-community/Laguna-S-2.1-oQ2e1.0001.0001.00040.8537.7787.38s
unsloth/Laguna-S-2.1-GGUF UD-Q2_K_XL0.8750.7501.00060.3737.99 RSS40.17s
pipenetwork/Laguna-S-2.1-MLX-3bit0.8750.7501.00058.6352.8865.82s
unsloth/Laguna-S-2.1-GGUF UD-Q3_K_M0.8750.7501.00051.2751.34 RSS65.19s
unsloth/Laguna-S-2.1-GGUF UD-IQ4_XS0.8750.7501.00051.0454.64 RSS54.23s
unsloth/Laguna-S-2.1-GGUF UD-IQ4_NL0.8750.750

项目描述

Community benchmarks and scripts for running Poolside Laguna S 2.1

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

lopopolo
精选
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI 与机器学习AI 智能体
2,390
slvDev
精选
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI 与机器学习大语言模型
1,960
littledivy
精选
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI 与机器学习
1,482