Adapt Intent Parser

Adapt is a keyword and rule based intent parser. It reads an utterance and matches it to a registered intent, then extracts the entity values the intent needs. This repository provides an OVOS pipeline plugin and bundles a maintained fork of the original MycroftAI/adapt parser, from the now-defunct MycroftAI.

Three OPM pipeline entry points are exposed:

ovos-adapt-pipeline-plugin (AdaptPipeline), the flat pipeline. It wraps a single IntentDeterminationEngine and all skills share one trie.
ovos-adapt-domain-pipeline-plugin (DomainAdaptPipeline), a per-skill pipeline. It wraps DomainIntentDeterminationEngine. Each skill_id gets its own sub-engine ("domain"). At match time every domain is scored in parallel and the global argmax wins. Configure it under intents.ovos_adapt_domain_pipeline.
ovos-adapt-hierarchical-pipeline-plugin (HierarchicalAdaptPipeline), the same per-skill domain model, with two-stage routing. A stage-1 classifier picks one domain, then only that domain's sub-engine is scored. Configure it under intents.ovos_adapt_hierarchical_pipeline.

See Pipeline variants for when to use each.

Install

pip install ovos-adapt-parser

Usage

The adapt parser also works standalone, with no OVOS and no messagebus:

from ovos_adapt.intent import IntentBuilder
from ovos_adapt.engine import IntentDeterminationEngine

engine = IntentDeterminationEngine()

# register vocabulary: surface forms grouped by entity type
for word in ["weather", "forecast"]:
    engine.register_entity(word, "WeatherKeyword")
for city in ["Seattle", "San Francisco", "Tokyo"]:
    engine.register_entity(city, "Location")

# build an intent over those entity types
weather = IntentBuilder("WeatherIntent") \
    .require("WeatherKeyword") \
    .require("Location") \
    .build()
engine.register_intent_parser(weather)

# match
for intent in engine.determine_intent("what is the forecast in Tokyo"):
    if intent.get("confidence", 0) > 0:
        print(intent)

In a full OVOS install the plugin runs as a pipeline stage instead. Skills register vocabulary and intents over the messagebus, and the plugin matches incoming utterances automatically. More runnable examples ship in the examples/ folder.

Documentation

A full guide, from first concepts to internals, lives in docs/:

Concepts, entities, intents, cliques, and confidence
Quickstart, install, enable, match your first utterance
Writing intents, the IntentBuilder API with examples
Configuration, confidence tiers and every config key
Pipeline variants, the flat, domain, and hierarchical plugins
Bus protocol, the messagebus API skills register over
Internals, tagging, clique expansion, and the confidence math
Engine comparison reference, how the variants diverge

OpenVoiceOS/ovos-plugin-manager, discovers and loads this plugin by its OPM entry point.
OpenVoiceOS/ovos-padatious-pipeline-plugin, a model-based intent matcher that runs alongside Adapt in the same pipeline.
OpenVoiceOS/ovos-workshop, the skill framework that registers vocabulary and intents with this plugin.
MycroftAI/adapt, the original parser this plugin's engine is forked from.

Reporting issues

Adapt is difficult to debug without full context. Include a serialized copy of the intent determination engine, using the debug dump utilities:

from ovos_adapt.engine import IntentDeterminationEngine

engine = IntentDeterminationEngine()
# load engine with vocabulary and parsers

import ovos_adapt.tools.debug as atd

atd.dump(engine, 'debug.ovos_adapt')

License

Apache License 2.0. See LICENSE.md.

Metadata

Release files for ovos-adapt-parser 1.6.4a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ovos-adapt-parser 1.6.4a1
File	Size	Uploaded
ovos_adapt_parser-1.6.4a1.tar.gz	68.2 kB	Sep 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ovos-adapt-parser 1.6.4a1
File	Interpreter	ABI	Platform	Reset
ovos_adapt_parser-1.6.4a1-py3-none-any.whl 48.9 kB Sep 10, 2026	Python 3	none	any	Details

Total release size: 117.1 kB

Release files / ovos_adapt_parser-1.6.4a1.tar.gz

Download URL	ovos_adapt_parser-1.6.4a1.tar.gz
Size	68.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`a9eb1a61bb8397dfcde686beabb83b942bf8b9241d361bddc9a0c93cdf8b30e3`
BLAKE2b-256 checksum How to use checksums	`6c902dae840befde4f1d658fcfdbb02f4a68dab2c352ed0bb196182e59de5e95`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / ovos_adapt_parser-1.6.4a1-py3-none-any.whl

Download URL	ovos_adapt_parser-1.6.4a1-py3-none-any.whl
Size	48.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3b0ee13ba6d5bce07c038a7d9a738b470e63c9065cd7d33f4cca39503f39133a`
BLAKE2b-256 checksum How to use checksums	`63aa4023f41613c1afc6302df3729b6fa79ba2dcd5ab452e6101967a3992e5b5`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`