whisperX
WhisperX for automatic speech recognition with word-level timestamps and diarization
GraphCanon updated 3w · GitHub synced 3w
Decision brief
WhisperX is an Automatic Speech Recognition tool that provides ASR with word-level timestamps and speaker identification using Python.
Good fit when
- When you need precise automatic speech recognition (ASR) with word-level timestamps for accurate transcription and synchronization needs.
- When your application requires diarization capabilities, allowing for the identification of different speakers within the audio.
Avoid when
- Avoid WhisperX if you require a lightweight solution as it may necessitate additional installations like CUDA and ffmpeg.
- Do not use this tool if your environment is constrained to CPU-only operations without access to the required GPU acceleration libraries, as performance limitations could be significant.
Observed Jul 17, 2026 · Source: enrich:decision_facts
Verify the decision
Maintenance and security
Full trust report- Maintenance
- Active (16d since push)
- As of 3w
- Provenance
- Not a fork · Personal account
- As of 3w
- Security (OSV)
- No lockfile
- As of 1mo
Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.
Install
pip install whisperXHow it fits your stack(1)
Typed graph edges - alternatives, integrations, successors, and dependencies. Ranked by relationship type, not raw GitHub stars.
Relationship graph
Optional deeper exploration of typed edges and category neighbours.
Similar tools
Same-category neighbours not already linked as typed edges.
Evidence and technical details
Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.
Overview
A tool that provides precise ASR with timestamps and speaker identification in Python.
Capability facts
- CLI
- CLI entrypoint
Source: pyproject.toml:[project.scripts] · Jul 30, 2026
- Languages
- python
Source: github.language+pyproject.toml · Jul 30, 2026
Categories
Compatibility
Sourced claims from the README excerpt - not unsourced marketing copy.
Tags
README
0. CUDA Installation
To use WhisperX with GPU acceleration, install the CUDA toolkit 12.8 before WhisperX. Skip this step if using only the CPU.
- For Linux users, install the CUDA toolkit 12.8 following this guide: CUDA Installation Guide for Linux.
- For Windows users, download and install the CUDA toolkit 12.8: CUDA Downloads.
1. Simple Installation (Recommended)
The easiest way to install WhisperX is through PyPi:
pip install whisperx
Or if using uvx:
uvx whisperx
2. Advanced Installation Options
These installation methods are for developers or users with specific needs. If you're not sure, stick with the simple installation above.
Option A: Install from GitHub
To install directly from the GitHub repository:
uvx git+https://github.com/m-bain/whisperX.git
Option B: Developer Installation
If you want to modify the code or contribute to the project:
git clone https://github.com/m-bain/whisperX.git
cd whisperX
uv sync --all-extras --dev
Note: The development version may contain experimental features and bugs. Use the stable PyPI release for production environments.
You may also need to install ffmpeg, rust etc. Follow openAI instructions here https://github.com/openai/whisper#setup.
For agents
This page has a .md twin and JSON over the API.