Laguna XS 2.1

Laguna XS 2.1

用一个 33B 的混合专家模型写代码、完成需要调用工具的长编程任务，每个词元只激活 3B 参数。适合在本地运行编程智能体的开发者。

由 poolside 在 Hugging Face 上制作。这些说明是 Mindket 根据它的模型页面和模型卡写的，模型自己的文件和许可证在 Hugging Face 上。

简介

它是什么：Laguna XS 2.1 是 poolside 推出的文本生成模型，面向智能体式编程和本地机器上的长时间工作。它是混合专家模型，总参数 33B，每个词元激活 3B。它升级自之前的 Laguna XS.2，在多项编程基准上得分更高。

适合谁：适合想在自己硬件上运行编程模型，并且需要长上下文和可选的逐步思考的开发者。

行业 | 谁在用 | 怎么用 | 例子
软件 | 开发者 | 在本地机器上运行编程智能体 | 让它在整个代码仓库里修一个 bug
开源工作 | 贡献者 | 用宽松许可的模型起草改动和测试 | 写一个补丁和覆盖它的测试
AI 研究 | 模型评测者 | 把活跃规模小的模型与更大的模型比较 | 用你自己的任务对照说明页的基准表

需要处理图像或音频的人可以跳过，因为说明页列出的是文本输入、文本输出。

用在哪里：

• 带 transformers 库的 Python：记录里把它列为所用的库。
• Ollama 和 llama.cpp：说明页称模型在那里可用。
• OpenRouter：说明页链接了一个托管版本。
• 内存 36 GB 的 Mac：说明页称模型小到可以在上面运行。

使用场景 | 谁用 | 得到什么
智能体式编程 | 开发者 | 通过工具调用和简短思考步骤产生的代码改动
长任务 | 开发者 | 在 262,144 词元的上下文窗口内完成工作
本地运行 | Mac 开发者 | 一个能放进 36 GB 内存机器的量化副本

如何设置：

先准备好：

• Python 和 pip，用来下载文件。
• 放权重的内存：BF16 约 66.9 GB，4 位估计约 16.7 GB。
• 或者用量化副本：说明页提到了 FP8、NVFP4 和 INT4 版本。

1. 用 pip 安装 Hugging Face hub 包。
2. 用 hf 命令下载模型。
3. 用 transformers 加载，或在 Ollama 或 llama.cpp 里运行量化副本。

pip install -U huggingface_hub
hf download poolside/Laguna-XS-2.1

如何使用：

你用聊天形式给它一个编程任务。它可以在工具调用之间思考，每个请求都可以开启或关闭思考。说明页的用法部分不在这里能看到的文本里，所以代码请查看模型页面。

示例：

你让它找出并修好项目里一个失败的测试，它有读文件和运行命令的工具。它一步步完成任务，在工具调用之间思考，最后返回一个修复方案。

新手与专家：

这是一个为编程工作调校的语言模型。一个好的第一步是在内存足够的机器上用 Ollama 试一个量化副本，给它一个很小的编程问题。

33B 参数里每个词元只运行 3B，所以这个模型相对它的体量很轻。它的 40 层里，10 层用全局注意力，30 层用 512 词元的滑动窗口。KV 缓存用 FP8 存储。代价是，在说明页的表里，它的基准分数低于一些更大的模型。

发送带工具的编程任务
模型先思考，再调用工具
它读取工具结果并继续
它返回最终答案或补丁

注意事项：说明页比较了编程基准上的分数。这张图展示 SWE-bench Verified。

Title: SWE-bench Verified，解决的百分比
Laguna XS 2.1: 70.9 percent
Laguna XS.2: 69.9 percent
MAI-Code-1-Flash: 71.6 percent
Claude Haiku 4.5: 73.3 percent
Qwen3.6-35B-A3B: 73.4 percent

• 体量：334 亿参数，256 个专家加 1 个共享专家。
• 上下文：262,144 词元。
• Terminal-Bench 2.0：这个模型 37.5 percent，之前的 XS.2 是 35.7 percent。
• License: OpenMDW-1.1，说明页称它完全宽松，包括商用产品。
• Cost to run: 运行权重不需要 API 密钥或账号。说明页提到用 OpenRouter 托管使用，并可按需提供支持。
• Data it reaches: 你从 Hugging Face 下载的文件，以及你给它的提示词和代码。
• Not for: 图像或音频输入，因为它是文本到文本。

Hugging Face 上的数据（2026年11月13日）

• 任务：text generation
• 框架：transformers
• 参数量：33.4B
• Weights: about 66.9 GB in BF16; about 16.7 GB at 4-bit (estimate)
• Formats: Safetensors
• 最近 30 天下载：633,340
• 点赞：268
• 许可证：openmdw-1.1
• Quantized versions: 39
• Fine-tunes: 13
• 标签：transformers, safetensors, laguna, text-generation, laguna-xs-2.1, vllm, conversational

链接

• 模型：https://huggingface.co/poolside/Laguna-XS-2.1
• 文件：https://huggingface.co/poolside/Laguna-XS-2.1/tree/main

获取模型

用 Hugging Face 的命令行下载它的文件：

pip install -U huggingface_hub
hf download poolside/Laguna-XS-2.1

然后按它的模型卡使用它。这个工具包里没有会自己运行的东西。