--- license: apache-2.0 library_name: inworld-sava pipeline_tag: voice-activity-detection tags: [audio, speech, voice-activity-detection, vad, semantic-vad, turn-detection, end-of-turn, streaming, realtime] ---
Semantic acoustic voice activity: streaming speech and end-of-turn detection in one model with an open license.
--- ## TL;DR SAVA returns two probabilities for a live audio stream: * `speech` → whether a frame holds speech * `turn` → whether the speaker's turn has ended The model's shared network uses acoustic and sentence context to distinguish speech from coughs, laughs, music and keyboard clatter. | | SAVA | |---|---| | made for | voice activity and conversational turn taking | | input | 16 kHz mono audio | | output | two probabilities every 40 ms | | timing | speech probability for a frame is emitted 120 ms later (lookahead); end-of-turn probability has no lookahead | | parameters | 25.5M | | execution | plain PyTorch, CPU or an explicitly selected device | Use it to open a turn when speech starts and close it when the sentence is complete. The [reference turn policy](https://github.com/inworld-ai/sava/blob/main/docs/USAGE.md) turns the probabilities into segments; applications can supply their own policy. SAVA responds to any voice. It does not pick out a target speaker, and it leaves interruptions and backchannels to the application's dialogue policy. ## Quick start Using a coding agent? Point it at the [setup section of AGENTS.md](https://github.com/inworld-ai/sava/blob/main/AGENTS.md#setting-up-sava-for-a-user): it installs the package, checks the machine with `sava-doctor` and runs SAVA on a first recording. With Python 3.10 or later: ```bash python -m pip install inworld-sava # Or from a clone: git clone https://github.com/inworld-ai/sava && cd sava && python -m pip install -e . sava run recording.wav sava run recording.wav --turns_dir turns/ --curves curves.json ``` ```python from inworld import sava model = sava.load("inworld/sava") curves = sava.run(model, sava.load_audio("recording.wav")) turns = sava.segment(curves, sava.Policy(), model.lookahead_frames) session = sava.Session(model) for piece in pieces_of_16k_audio: # One-dimensional floating-point mono samples. frames = session.push(piece) frames = session.flush() ``` `sava.load("inworld/sava")` and the CLI's default model download the weights on first use and verify their checksum. The CLI defaults to CPU; `--device` selects another device. For microphone input, install `python -m pip install "inworld-sava[mic]"` and run `sava mic`. The code, [the integration guide](https://github.com/inworld-ai/sava/blob/main/docs/USAGE.md) and the [benchmarks](https://github.com/inworld-ai/sava/blob/main/bench/README.md) are on GitHub: [inworld-ai/sava](https://github.com/inworld-ai/sava). ## Hardware Tested on NVIDIA Ampere, Hopper and Blackwell GPUs and on CPU. On an Apple M3 Max CPU one stream takes 3.8 ms per 40 ms frame; [the integration guide](https://github.com/inworld-ai/sava/blob/main/docs/USAGE.md) lists the measured configurations. ## The benchmarks
Built for people with ❤️ by Inworld.