The Open-Source AI Stack

The Stack · Runtime · Open source

Outlines

Structured-output library using finite-state-machine guided decoding to force model output to match a regex, JSON Schema, or grammar.

Apache 2.0 · stable · Project site → · GitHub →

Outlines, from the team at .txt (dottxt), is a library for structured generation: it constrains a model so its output is guaranteed to match a regular expression, a JSON Schema, or a context-free grammar. It does this by compiling the target into a finite-state machine and masking the next-token distribution at each step so only tokens that keep the output valid can be sampled. The approach is the one described in Willard and Louf's 2023 paper on efficient guided generation. Among the structured-output libraries, Outlines is the most research-anchored and one of the most widely integrated. It is used as a constrained-decoding backend inside open serving engines rather than only as a standalone tool, which puts it next to XGrammar and llguidance as one of the engines doing the actual token masking. Instructor and Guidance sit a layer above, oriented around developer ergonomics, while Outlines is closer to the mechanism. It matters for open-source AI because schema-conforming output is what makes open models usable as reliable components in code, rather than as chat boxes whose output has to be defensively parsed. Production teams reach for it when extraction, classification, or function-call arguments must be valid every time.

Sources

Want a follow-up? Ask the chat about Outlines in context. It will compare to siblings at the same layer and ground every claim in the wiki.

Other projects at the Runtime layer

12 siblings · ordered open first