xgrammar

让大模型输出严格符合格式,又快又稳

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 262 🐛 待处理 160 👀 关注 17
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1996
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,Apache-2.0许可证,完全免费,可自行部署使用。

项目预览

xgrammar 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队mlc-ai
定价模式🏷️完全免费
价格说明开源项目,Apache-2.0许可证,完全免费,可自行部署使用。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Python
技术栈/模型large-language-models,structured-generation
GitHub 星标★ 1996
上线时间2024-06-28 00:00:00
代码更新2026-11-07
仓库体积15.8 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数5

项目介绍

xgrammar 是一个专注于结构化生成的开源库,旨在为大型语言模型提供快速、灵活且可移植的约束解码能力。它解决了 LLM 输出不符合预期格式(如 JSON、SQL 或自定义语法)的问题,通过将语法规则编译为有限状态机,在解码过程中实时约束 token 生成,确保输出严格符合预定义模式。核心能力包括高性能的掩码计算、支持上下文敏感语法(如 JSON Schema)、支持多种后端(如 llama.cpp、vLLM)以及多种语言绑定(C++、Python)。其设计强调可移植性,能轻松集成到不同的推理框架中,从而提升生成结果的结构化程度和可靠性。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1996

技术标签

使用教程

⚠ 本教程由 AI 依据该项目 README 整理;原始文档不完整,部分步骤为通用流程推断,实际安装请以项目官方文档为准。

难度:入门 约 10 分钟 部署方式:库/依赖 3 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Python 环境(xgrammar 提供 Python 语言绑定)
  • C++ 环境(项目使用 C++ 开发、提供 C++ 绑定)
  • 如需在推理框架中使用,需自备 vLLM、llama.cpp 等已集成后端

安装与启动步骤

  1. 1克隆仓库

    从 GitHub 地址拉取 xgrammar 源码到本地,便于查看代码与文档目录。

    git clone https://github.com/mlc-ai/xgrammar.git
  2. 2查阅官方文档

    README 未给出安装命令,请打开官方文档的 Get Started 章节获取准确安装步骤。

  3. 3了解新版本特性

    README News 显示 2026/5 已发布 XGrammar-2,可阅读官方博客确认版本与能力变化。

如何确认成功

README 未说明验证方式,请按官方文档 Get Started 章节的指引确认是否可用。

常见问题

Q:xgrammar 支持哪些推理后端?

A:README News 显示已集成 vLLM、TensorRT-LLM、OpenVINO GenAI、Modular MAX、Mirai 等,官方介绍中也提到 llama.cpp 等后端。

Q:提供哪些语言绑定?

A:项目信息显示提供 C++ 和 Python 两种语言绑定,可按使用场景选择。

Q:最新版本是什么?

A:README News 显示 2026 年 5 月发布了 XGrammar-2,详情见官方博客链接。

Q:完整文档在哪里?

A:官网文档地址为 https://xgrammar.mlc.ai/docs/ ,README 顶部也提供了 Get Started 入口。

注意事项

  • README 节选中没有安装命令,不要照搬任何未在文档中出现的包名或参数。
  • 项目迭代活跃(已发布 XGrammar-2),安装前建议先看官方文档与 News 确认版本。
  • 其核心用途是结构化生成,让模型输出严格符合 JSON、SQL 或自定义语法。

核心亮点

  • 基于有限状态机的约束解码,性能开销极低,比正则表达式方法快数倍
  • 支持 JSON Schema 等上下文敏感语法,能处理复杂嵌套结构
  • 提供 C++ 核心与 Python 绑定,并已集成到 vLLM、llama.cpp 等主流推理框架

不足之处

  • 文档和示例相对较少,新用户上手需要参考源码或社区讨论
  • 对非 JSON 的自定义语法支持仍在完善,部分高级语法特性可能受限

适用场景

  • 在 LLM 应用中强制输出合法 JSON,避免解析错误
  • 需要生成符合特定数据库 Schema 的 SQL 查询
  • 在推理服务中集成结构化输出,提升下游自动化流程的稳定性

替代项目

Outlines、Guidance、LlamaIndex Structured Output

上一篇:llm-sandbox

下一篇:MoE-Infinity

同类项目推荐

ollamafreeapi 开源

不装显卡不填Key,直接调用50+开源大模型

OllamaFreeAPI: Free Distributed API for Ollama LLMs Public gateway to our managed O···

★ 338 2026-10-15
ADI-Stable-Diffusion 开源

用 C++ 和 ONNXRuntime 让 Stable Diffusion 推理飞起来

Accelerate your Stable Diffusion inference with the library's universal C/C++ framew···

★ 465 2026-08-09
airgate-core 开源

插件化 AI 网关,多账号调度+计费,一键部署拼车共享

插件化 AI 中转网关,平台能力以 gRPC 插件独立装载,支持多账号调度、计费与拼车共享,do···

★ 63 2026-08-09
pixeltable 开源

像用数据库一样管理多模态 AI 数据,省去管道工程

The backend agents build with - Multimodal database, orchestration, and serving in o···

★ 1659 2026-08-09
openllmetry 开源

用 OpenTelemetry 一键监控你的大模型应用,看清每次调用和成本。

Open-source observability for your GenAI or LLM application, based on OpenTelemetry

★ 7527 2026-08-09
space 开源

一个框架管好机器学习全流程的存储,告别散乱文件

Unified storage framework for the entire machine learning lifecycle

★ 157 2026-08-09
jangq 开源

把 GGUF 模型搬上 Mac 的 MLX,量化后照样跑得动

JANG — GGUF for MLX. YOU MUST USE JANG_Q RUNTIME. Adaptive Mixed-Precision Quantiza···

★ 232 2026-10-16
OpenMLDB 开源

用SQL统一训练与推理特征,告别线上线下不一致

OpenMLDB is an open-source machine learning database that provides a feature platfor···

★ 1716 2026-08-09
redis-vl-python 开源

用 Redis 做向量检索,一套 Python 库搞定 AI 数据层

Redis Vector Library. The AI-native Python client for Redis.

★ 434 2026-08-09