modelscope /FunASR

Open-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.

★ 21,033⑂ 2,129👁 113⑃ 2,001● 1,809▤ 87
PythonMITCreated 2022-11-24
Download: v1.4.26v1.4.26 ↓1.4.262026-11-12
+8
Daily
+109
Weekly
+329
Monthly
21,033
stars
2,129
forks
113
watchers
2,001
prs
1,809
issues
87
releases

README

(简体中文|English|日本語|한국어)






  Industrial speech recognition toolkit for offline, streaming, and edge deployment.
  ASR · VAD · punctuation · speaker pipelines · emotion and audio-event models · OpenAI-compatible serving



  
  
  
  
  







  Quick Start · Model selection · Models · Deployment matrix · Deployment hub · Docs · Benchmark · Contribute


---

 Quick Start

 Native Transformers

For Fun-ASR-Nano transcription with the Hugging Face API, start with the Transformers 5.17.0 CPU quickstart. No FunASR toolkit or remote Python code is needed.

Space · Notebook · Python / batch examples

 FunASR toolkit and pipelines



No local setup? Open the Colab quickstart to transcribe a public sample or upload your own audio in a browser.

Found FunASR useful? Star the project so more builders can find it.

bash
 CPU-only installs can use the default PyPI wheels.
pip install torch torchaudio
pip install funasr


For GPU quickstarts, install the PyTorch and torchaudio wheels that match your
NVIDIA driver from pytorch.org
before installing FunASR. After installation, confirm the GPU is visible:

bash
python -  Deploy as API server: Local SenseVoice CPU recipe · Nano GPU serving and pinned vLLM setup

 Use with AI agents: MCP Server for Claude/Cursor · OpenAI API for LangChain/Dify/AutoGen

 Use with voice agents: OpenClaw realtime plugin (experimental; requires an unmerged upstream SDK patch) · Hugging Face speech-to-speech with SenseVoice (merged source checkout; not in v1.0.0)

 Why FunASR?

FunASR is a toolkit: choose the task, checkpoint, and runtime separately.
Support in one model or adapter does not imply support in every serving backend.

| Task | Checkpoint or pipeline | Runtime entrypoint | Important limitation |
|---|---|---|---|
| File transcription with emotion/event tags | SenseVoiceSmall | Python AutoModel, CPU or GPU | Five-language checkpoint; tags do not identify speakers. |
| LLM-based file transcription | Fun-ASR-Nano | AutoModel; split-engine AutoModelVLLM for the documented GPU path | Base Nano covers zh/en/ja and Chinese dialects/accents; timestamp support depends on checkpoint and path. |
| Broader multilingual transcription | Fun-ASR-MLT-Nano | Python AutoModel | Separate 31-language checkpoint; do not transfer its coverage to base Nano. |
| Chunked live transcription | Paraformer-zh-streaming | Streaming SDK or runtime WebSocket service | Use the streaming checkpoint and per-session cache, not an offline checkpoint. |
| Speaker-aware file transcription | SenseVoiceSmall + FSMN-VAD + CAM++ | AutoModel with VAD and embedding clustering | Anonymous indices within a recording, not enrolled-speaker identification. |
| Joint text, timestamps, and speakers | MOSS-Transcribe-Diarize, third-party OpenMOSS | FunASR adapter or upstream backend in the MOSS guide | Offline, recording-local anonymous labels; no external VAD/speaker pipeline for its unified path. |
| Native CPU/edge transcription | Fun-ASR-Nano or SenseVoiceSmall GGU

Top issues

Discussions

Latest release

v1.4.26 v1.4.26 2026-11-12
Final Publication Acceptance

GitHub Release and PyPI 1.4.26 are published. Both official PyPI distributions were downloaded and match GitHub by SHA-256 and size:

- funasr-1.4.26-py3-none-any.whl: 1015738 bytes; SHA-256 104e3704fed0ecfd6c08836468de147a2c6f05745281093b8a6dbe341d1ce831.
- funasr-1.4.26.tar.gz: 1086172 bytes; SHA-256 763c7d860a49afd17e4b9c0636ff43f03f6519e68bd0a09a25d68318091e2cf8.


 FunASR 1.4.26

Source: cdd82b5cbfd05015f8fb2b167d61f25142c3a9e8 / tag v1.4.26.

 Fixes

- 3874: response_format=text now returns the bare HTTP transcript instead of a JSON-quoted string.
- 3872 / 3

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON