---
title: "Hotword biasing (contextual biasing)"
description: "Hotword biasing tells a speech model which names and terms to expect, so it favours them when the audio is close, with no retraining. How it works, by example."
canonical: "https://www.fermionresearch.com/glossary/hotword-biasing/"
source: "Fermion Research"
---

Glossary/facts checked 13 November 2026

# Hotword biasing (contextual biasing)

Also called contextual biasing, keyword boosting or custom vocabulary. The main methods, how decode-time biasing behaves, and the Phonon-2 hotwords syntax as a worked example.

[Phonon-2 hotwords in the CLI reference](https://www.fermionresearch.com/docs/cli-reference/)

## The short answer

Hotword biasing is a way to give a speech recognition model a short list of names and terms to expect, so that it favours them when the audio sounds close, without retraining the model. It fixes the most visible class of errors: product names, people, places and jargon that a general model spells wrong.

Good biasing only tips close calls. A listed word that was not said should stay out of the transcript, and without a list the output should not change.

## Ways to teach a model new words

Biasing at decode time is one of several approaches. They differ in when they act and what they cost.

| Method | When it acts | Retraining | Handles a word the model never saw | Main risk |
| --- | --- | --- | --- | --- |
| Hotword list at decode time | During decoding, per request | No | Often, if the spelling can be built from the model's tokens | Too strong a bonus inserts listed words that were not said |
| Contextual language model or class grammar | During decoding, from an external language model | The language model only | Yes, if added to the grammar | Extra component to maintain |
| Neural contextual biasing (for example CLAS) | Inside the model, from embeddings of the phrase list | Yes, the model is trained to use lists | Yes | Needs a model built for it |
| Fine-tuning on domain audio | Before deployment | Yes | Yes, if the data contains it | Cost, and drift on general speech |

## How decode-time biasing works

A decoder keeps several candidate transcripts and scores each one as it goes. With a hotword list, a candidate whose latest tokens spell the start of a listed term gets a small score bonus, and keeps it if the term is completed. A weight controls how big the bonus is: too small and nothing changes, too large and the model starts hearing listed words in unrelated audio.

Neural contextual biasing goes further. Pundak et al. ("Deep context", arXiv 1808.02480, 2018) trained a Listen, Attend and Spell model jointly with embeddings of the context phrases, and reported up to 68 % relative WER reduction over a baseline that combined separate models by shallow fusion.

## Example: hotwords in Phonon-2

Phonon-2 takes up to 25 hotwords on every engine it runs on: Apple silicon, the CPU engine on Linux, Windows and macOS, and the CUDA image. Multi-word terms such as Ada Lovelace are kept whole. --hotword-lambda sets how hard listed words pull, with a default of 2.0. A listed word that was not said stays out of the transcript.

On the server, send a hotwords field per request, or the OpenAI prompt field, which is read as a vocabulary list. Hotwords apply only to the request that sends them. Hotwords are not part of the current Phonon-2.5 release; today they are a Phonon-2 feature.

Practical tips: list the exact spellings you want to see, keep the list to terms that are likely in this audio, and measure a sample of your own recordings with and without the list before turning the weight up.

```text
fermion transcribe phonon-2 call.wav --hotwords "Ada, Quillon"
fermion transcribe phonon-2 call.wav --hotwords @names.txt
curl -s http://127.0.0.1:8000/v1/audio/transcriptions -F file=@call.wav -F model=phonon-2 -F "hotwords=Ada, Quillon"
```

## Questions

## Related

- [Custom vocabulary speech recognition](https://www.fermionresearch.com/speech/custom-vocabulary-speech-recognition/)
- [Phonon-2](https://www.fermionresearch.com/models/phonon-2/)
- [CLI reference](https://www.fermionresearch.com/docs/cli-reference/)
- [Server reference](https://www.fermionresearch.com/docs/server-reference/)

## Sources and method

- Pundak, Sainath, Prabhavalkar, Kannan, Zhao, Deep context: end-to-end contextual speech recognition, arXiv 1808.02480 (2018-08-07), read 2026-11-13.
- Phonon-2 hotwords: Fermion Research docs (/docs/speech/, /docs/cli-reference/, /docs/server-reference/) and github.com/fermionresearch/phonon docs/hotwords.md, read 2026-11-13.

Canonical: https://www.fermionresearch.com/glossary/hotword-biasing/

Source: [https://www.fermionresearch.com/glossary/hotword-biasing/](https://www.fermionresearch.com/glossary/hotword-biasing/)
