KoljaB/RealtimeSTT is tracked by TopGit as a developer tool, with 10.2k stars on GitHub, written primarily in Python. A robust, efficient, low-latency speech-to-text library with advanced voice activity detection, wake word activation and instant transcription.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
License: RealtimeSTT's own code is Apache-2.0. Engines, models, VADs and
wake-word backends keep their own licenses, which you must check yourself:
license notes.
RealtimeSTT is a Python speech-to-text library for applications that need
voice activity detection, fast transcription, optional realtime text updates,
wake words, and direct access to audio streams. It is designed for assistants,
dictation tools, browser streaming servers, and prototypes that need to turn
speech into text with only a few lines of code.
The general-purpose default path uses faster_whisper. Other engines are
available through install extras when their optional dependencies and models
are present.
New in 1.2.0: fast pause transcripts for voice assistants
A voice assistant has to decide, every time the user pauses, whether the turn
is over and what was said. The sooner it has a reliable transcript of the
words so far, the sooner it can judge the turn, start the language model, and
answer. RealtimeSTT 1.2.0 makes that transcript (the Preview) much faster
on the production server:
Live-flush Preview (--preview-live-flush, new nemotron_ort engine).
At a pause the streaming model decodes the audio it has not yet finalized on
a copy of its state, so the live stream continues undisturbed. The Preview
arrives in tens of milliseconds instead of waiting for a full re-decode. The
accurate full-model text follows as a separate previewRecord event, and an
optional second flush stage (previewRefined) adds a slightly longer read.
Tail-anchored Preview (--preview-input-mode tail). Instead of
re-decoding the whole turn at every pause, the final model decodes only the
newest audio and joins it to the text already recognized. The cost no longer
grows with the length of the turn. If the join cannot be proven, the server
decodes the full turn.
Orukeet final model (stt-install-sherpa-models --model orukeet): an
optional, hash-verified Parakeet TDT derivative for 25 European languages.
Measured once on the Linux x86-64 production host, on a 12-second English
utterance: live-flush Preview 48 ms, tail-mode Preview 149 ms, and a
full-turn Preview about 710 ms, from request to event.
These fast paths are CPU only.nemotron_ort runs on ONNX Runtime's CPU
provider, and the tested profile is the CPU Nemotron/Orukeet pair on Linux
x86-64. On GPU, faster_whisper remains the recommended general-purpose path
and does not offer live flush.
The client sends {"type":"preview","previewRequestId":"pause-1","pauseTextSource":"live_flush"}
when it detects a pause. Protocol details, fallbacks and events are in the
production server guide.
The nemotron-ort extra pins onnxruntime==1.23.2; do not combine it with the
parakeet-onnx extra in one environment. Full change list:
release notes.
Recommended Engine Profiles
CUDA / GPU: Keep using the established faster_whisper CUDA setup. It
remains the recommended general-purpose GPU path.
CPU: For production streaming on Linux x86-64, the strongly recommended
profile is
sherpa-onnx-nemotron-3.5-asr-streaming-0.6b-560ms-int8 for fast,
replaceable realtime text together with
sherpa-onnx-nemo-parakeet-tdt-0.6b-v3-int8 for the single authoritative
final transcript. Nemotron processes only new audio frames during the turn;
Parakeet then refines the complete turn once at finalization. This pairing
provides substantially better CPU streaming behavior than repeatedly
retranscribing a growing audio buffer while preserving a high-quality final.
Install the CPU server stack and both pinned model bundles with:
python -m pip install "RealtimeSTT[server,sherpa-onnx]"
stt-install-sherpa-models --root ./models/sherpa-onnx --model all
See the production server guide for
the authenticated HTTP/WebSocket deployment recipe and exact pinned model
directories.
Orukeet CPU performance: official runtime tuning
Official sherpa-ONNX 1.13.8 supports disabling CPU worker spinning through a
provider configuration file. On the tested Ubuntu 24.04 x86-64 / Python 3.12
host, seven threads with spinning disabled beat our earlier custom build:
107.2 versus 113.3 ms for five-second audio over 20 alternating-order rounds.
The same Orukeet INT8 model and CPU affinity were used; transcripts matched.
This configuration uses official PyPI wheels and requires no custom native build.
Install and enable it explicitly; the standard extra and model installer do not
automatically select a CPU performance profile. Seven threads is a measured
setting for one host. See the
installation, configuration and benchmark details.
Support RealtimeSTT
If RealtimeSTT saved you time, one GitHub star is a simple way to help make it more stable.
Stars improve visibility and visibility brings more users, more real-world testing, more bug reports, more fixes, and better releases for everyone.
RealtimeSTT includes native support for kroko_onnx, the local streaming ASR
engine from the Kroko/Banafo team.
This integration has been on my wishlist for a long time. Kroko is a strong fit
for RealtimeSTT's goals: fast, accurate local speech recognition.
Start with the public Community models for local testing, or see Kroko/Banafo's
commercial model options if you need production licensing and higher-end models.
For CUDA, platform notes, and optional engine stacks, see
docs/installation.md.
Microphone Example
This waits for speech, stops after the detected utterance, and prints the final
transcript:
from RealtimeSTT import AudioToTextRecorder
if __name__ == "__main__":
with AudioToTextRecorder() as recorder:
print("Speak now")
print(recorder.text())
Use the if __name__ == "__main__": guard when running scripts, especially on
Windows, because RealtimeSTT uses multiprocessing for model work.
Automatic Recording Loop
For continuous dictation, pass a callback to text() so transcription work can
complete asynchronously while your loop keeps listening:
from RealtimeSTT import AudioToTextRecorder
def process_text(text):
print(text)
if __name__ == "__main__":
recorder = AudioToTextRecorder()
while True:
recorder.text(process_text)
External Audio
Set use_microphone=False when audio comes from a file, stream, websocket, or
another process. Feed 16-bit mono PCM chunks at 16 kHz, or pass the original
sample rate so RealtimeSTT can resample:
from RealtimeSTT import AudioToTextRecorder
if __name__ == "__main__":
recorder = AudioToTextRecorder(use_microphone=False)
with open("audio_chunk.pcm", "rb") as audio_file:
recorder.feed_audio(audio_file.read(), original_sample_rate=16000)
print(recorder.text())
recorder.shutdown()
More examples are in docs/quick-start.md and
docs/external-audio.md.
Configuration Reference
Every AudioToTextRecorder constructor parameter is documented in
docs/configuration.md, including model/engine
selection, realtime transcription, VAD timing, wake words, callbacks, external
audio, logging, and executor injection.
Features
Voice activity detection with WebRTC VAD and Silero VAD.
Final and realtime transcription with selectable engines.
Optional wake word activation through Porcupine or OpenWakeWord.
Direct microphone input or application-fed audio chunks.
Event callbacks for recording, VAD, realtime text, transcription, and wake
word state.
A packaged production FastAPI server with versioned HTTP/WebSocket contracts,
session isolation, bounded shared inference resources, authentication, and
readiness/capabilities endpoints.
A browser streaming reference app for source checkouts.
Documentation
Quick start: shortest demos and common recording
patterns.
Installation: platform setup, CUDA notes, and optional
dependencies.
Configuration: complete AudioToTextRecorder
parameter reference.
Transcription engines: engine selection and
setup links.
Custom transcription engines: public
base class, executor integration, streaming sessions, and contribution guide.
Wake words: Porcupine and OpenWakeWord setup.
External audio: feeding audio without a microphone.
Testing: maintained unit and opt-in golden test workflow.
Test scripts: demos, manual tests, regressions, and
legacy experiments under tests/.
FastAPI server: browser server configuration,
protocol, metrics, and deployment notes.
Production server: packaged remote
HTTP/WebSocket API, authentication, limits, and deployment recipe.
Troubleshooting: common install, audio, CUDA,
model, dependency, and runtime errors.
Engine licenses: license notes for optional engine
runtimes and model families.
Engine-specific references:
faster-whisper
whisper.cpp
OpenAI Whisper
Moonshine
sherpa-onnx
Kroko-ONNX
Parakeet NeMo
Meta Omnilingual ASR
Granite/Qwen Transformers engines
Cohere Transcribe
FunASR
Production Server
The supported remote server is packaged as an optional install. It binds to
loopback by default and exposes versioned health, readiness, capabilities,
raw-PCM final transcription, and ordered streaming WebSocket endpoints.
Direct non-loopback binds require both a bearer token and Uvicorn TLS
certificate/key files; for a reverse-proxy deployment, keep the server on
loopback and terminate TLS at the proxy.
For CPU INT8 deployment, the recommended pairing is
sherpa-onnx-nemotron-3.5-asr-streaming-0.6b-560ms-int8 for live hypotheses
and sherpa-onnx-nemo-parakeet-tdt-0.6b-v3-int8 for authoritative final
transcription. Install RealtimeSTT[server,sherpa-onnx] and both pinned model
bundles into persistent storage before following the server recipe. The
server extra includes the local Silero ONNX VAD runtime used by legacy
recorder-backed server paths. The versioned production WebSocket path owns its
turn state and does not derive finalization from recorder VAD, so production
startup does not need an interactive Torch Hub download:
stt-install-sherpa-models --root ./models/sherpa-onnx --model all
See
PRODUCTION_SERVER.md.
The interactive browser reference app remains in example_fastapi_server for
source checkouts. See docs/fastapi-server.md for its
UI, engine recipes, protocol details, and metrics.
Contributing
Focused tests and small changes are easiest to review. The project keeps fast
unit tests separate from opt-in real-model tests; see docs/testing.md.
License
RealtimeSTT's own source code is licensed under the
Apache License 2.0; see also NOTICE. Releases up to and
including 1.1.2 were published under the MIT License.
This license covers the RealtimeSTT code only. It does not relicense, and does
not release you from checking and complying with, the licenses and terms of
the transcription engines, VAD and wake-word engines, model weights or hosted
services you use through this library. Some of them require attribution,
share-alike, a commercial license or a provider agreement. Start with the
license notes and verify the upstream terms for the exact
package, model and revision you ship.
The most recent commit recorded on KoljaB/RealtimeSTT was 6 days ago, based on the GitHub push timestamp. The repository has 860 forks — one of the better signals of community interest.
How does KoljaB/RealtimeSTT compare to other Developer Tools projects?
KoljaB/RealtimeSTT is tracked by TopGit in the Developer Tools category, with 10.2k GitHub stars and written in Python. Browse the Developer Tools topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does KoljaB/RealtimeSTT have?
KoljaB/RealtimeSTT has 10.2k GitHub stars — refresh the page for the live number, or check github.com/KoljaB/RealtimeSTT. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What is KoljaB/RealtimeSTT?
KoljaB/RealtimeSTT (KoljaB/RealtimeSTT) is a Python project on GitHub. From the project's own README: A robust, efficient, low-latency speech-to-text library with advanced voice activity detection, wake word activation and instant transcription.
What language is KoljaB/RealtimeSTT written in?
KoljaB/RealtimeSTT is written primarily in Python. GitHub's language field is based on the largest share of bytes in the default branch.
What topics is KoljaB/RealtimeSTT associated with?
GitHub's repository topics for KoljaB/RealtimeSTT: "python", "realtime", "speech-to-text". TopGit's editorial category is Developer Tools.
Why is KoljaB/RealtimeSTT categorized under Developer Tools?
TopGit places KoljaB/RealtimeSTT in the Developer Tools category based on its GitHub topics and description (tagged: "python", "realtime", "speech-to-text"). Categories are assigned from real repository metadata, not editorial guesswork.
Read full README in the tab above.
Curious whether RealtimeSTT is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about RealtimeSTT.