MCPcopy Index your code
hub / github.com/ASLP-lab/SenSE

github.com/ASLP-lab/SenSE @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
438 symbols 1,663 edges 61 files 85 documented · 19%

Browse by type

Functions 360 Types & classes 78
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

SenSE: Semantic-Aware High-Fidelity Universal Speech Enhancement

arXiv demo models

<img src="https://github.com/ASLP-lab/SenSE/raw/main/figures/SenSE.png" width="900"/>

Installation

Create a separate environment if needed

# Create a python 3.10 conda env (you could also use virtualenv)
conda create -n sense python=3.10
conda activate sense

Install PyTorch with matched device

> # Install pytorch with your CUDA version, e.g.
conda install pytorch==2.3.0 torchvision==0.18.0 torchaudio==2.3.0 pytorch-cuda=12.1 -c pytorch -c nvidia

Then you can install the environment as follows:

cd SenSE
# git submodule update --init --recursive  # (optional, if need > bigvgan)
pip install -e .

Inference

Please read the Inference Guidance before running the inference code to ensure correct results.

Our models are available at https://huggingface.co/ASLP-lab/SenSE.

accelerate launch src/sense/eval/eval_infer_batch.py \
    --seed 0 \
    --llm_model SenSE_LLM_Base \
    --llm_ckpt_file "/path/to/llm_ckpt" \
    --fm_model SenSE_CFM_Base \
    --fm_ckpt_file "/path/to/cfm_ckpt" \
    --exp_name evaluation \
    --save_sample_rate 16000 \
    --testset dns_challenge_no_reverb \
    --nfestep 8 \
    --cfg_strength 0.5 \
    --swaysampling -1 \
    # --no_ref_audio

Training

# for LLM stage training:
accelerate launch src/sense/train/train_llm.py \
    --config-name SenSE_LLM_Base.yaml

# for CFM stage training:
accelerate launch src/sense/train/train.py \
    --config-name SenSE_CFM_Base.yaml

Citation

If you find this work useful, please cite our paper:

@article{li2025sense,
  title={SenSE: Semantic-Aware High-Fidelity Universal Speech Enhancement},
  author={Li, Xingchen and Xie, Hanke and Wang, Ziqian and Zhang, Zihan and Xiao, Longshuai and Xie, Lei},
  journal={arXiv preprint arXiv:2509.24708},
  year={2025}
}

Acknowledgements

We sincerely thank all collaborators and Prof. Shuai Wang for their valuable contributions to this work and the accompanying paper.

In addition, this implementation is based on F5-TTS. We appreciate their excellent work.

Contact Us

If you are interested in leaving a message to our research team, feel free to email lixingchen0126@gmail.com.

<a href="http://www.nwpu-aslp.org/">
    <img src="https://github.com/ASLP-lab/SenSE/raw/main/figures/ASLP.jpg" width="400"/>
</a>

Core symbols most depended-on inside this repo

Shape

Method 214
Function 146
Class 78

Languages

Python100%

Modules by API surface

src/sense/model/modules.py54 symbols
src/sense/model/modules2.py38 symbols
src/sense/model/encoder/wavlm/wavlm.py23 symbols
src/sense/model/dataset.py22 symbols
src/sense/eval/ecapa_tdnn.py21 symbols
src/sense/model/encoder/conformer/convolution.py15 symbols
src/sense/model/utils.py14 symbols
src/sense/eval/utils_eval.py14 symbols
src/sense/model/backbones/dit.py13 symbols
src/sense/infer/utils_infer.py13 symbols
src/sense/model/encoder/conformer/modules.py12 symbols
src/sense/train/datasets/prepare_csv_wavs.py11 symbols

For agents

$ claude mcp add SenSE \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page