From a73e0f66ab63dd8cfc6366432d0c6ddb4bfc22e5 Mon Sep 17 00:00:00 2001
From: LauraGPT <18321252+LauraGPT@users.noreply.github.com>
Date: Tue, 22 Sep 2026 03:26:50 +0000
Subject: [PATCH 1/2] docs: correct contributor prerequisites and checkpoint
 scope

Signed-off-by: LauraGPT <18321252+LauraGPT@users.noreply.github.com>
---
 CONTRIBUTING.md | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4375a22..2a7aad8 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -6,7 +6,9 @@ Thank you for your interest in contributing to SenseVoice! This guide will help
 
 ### Prerequisites
 
-- Python 3.8 or higher
+- Python 3.12 is recommended for this guide. The current `torch>=2.12.1` requirement
+  needs Python 3.10 or newer; Python 3.8 and 3.9 cannot satisfy the current
+  dependency set.
 - Git
 - (Optional) CUDA-compatible GPU for faster inference
 
@@ -29,7 +31,7 @@ source venv/bin/activate  # On Windows: venv\Scripts\activate
 3. **Install dependencies:**
 
 ```bash
-pip install -r requirements.txt
+python -m pip install -r requirements.txt
 ```
 
 4. **Verify the installation:**
@@ -43,6 +45,8 @@ python -c "from funasr import AutoModel; print('Installation successful')"
 If you don't have a GPU, you can run SenseVoice on CPU by setting the device to `"cpu"`:
 
 ```python
+from funasr import AutoModel
+
 model = AutoModel(
     model="iic/SenseVoiceSmall",
     trust_remote_code=True,
@@ -127,13 +131,18 @@ SenseVoice/
 
 ## Understanding the Model
 
-SenseVoice is a non-autoregressive encoder-only model that outputs:
+The released SenseVoiceSmall checkpoint is a non-autoregressive encoder-only model that outputs:
 
-- **Speech transcription** (ASR) across 50+ languages
+- **Speech transcription** (ASR) for Mandarin, Cantonese, English, Japanese, and Korean
 - **Emotion labels**: `HAPPY`, `SAD`, `ANGRY`, `NEUTRAL`, `FEARFUL`, `DISGUSTED`, `SURPRISED`
 - **Audio event labels**: `BGM`, `Speech`, `Applause`, `Laughter`, `Cry`, `Sneeze`, `Breath`, `Cough`
 - **Language identification** for Mandarin, English, Cantonese, Japanese, and Korean
 
+The broader SenseVoice research reports support for more than 50 languages; that is
+not the language support of the released SenseVoiceSmall checkpoint. See the
+[README](./README.md) for the distinction between research scope and released
+capabilities.
+
 The model uses a SANM (Self-Attention with Normalized Memory) encoder architecture with CTC decoding. Emotion and event labels are predicted from the first 4 encoder output tokens, while the remaining tokens produce the transcription.
 
 ## Docker

From db9d5ec6ff562dcd6062af38f7191d52e18802b4 Mon Sep 17 00:00:00 2001
From: LauraGPT <18321252+LauraGPT@users.noreply.github.com>
Date: Tue, 22 Sep 2026 05:44:23 +0000
Subject: [PATCH 2/2] docs: include FastAPI CLI prerequisite in contributor
 setup

Signed-off-by: LauraGPT <18321252+LauraGPT@users.noreply.github.com>
---
 CONTRIBUTING.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 2a7aad8..a371f22 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -54,9 +54,12 @@ model = AutoModel(
 )
 ```
 
-For the FastAPI server:
+For the FastAPI server, also install the CLI dependencies. The base `fastapi`
+package in `requirements.txt` does not include the `fastapi` command's optional
+dependencies:
 
 ```bash
+python -m pip install "fastapi[standard]"
 export SENSEVOICE_DEVICE=cpu
 fastapi run --port 50000
 ```