whatisgithub

What is zipenhancer?

gyj1201/zipenhancer — explained in plain English

Analysis updated 2026-05-18

51PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A self-hosted web service that removes background noise from audio files using three switchable AI models, with a simple upload-and-download API.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Clean up meeting recordings or voice memos by running them through the denoise API endpoint.

USE CASE 2

Batch process a whole folder of audio files to remove background noise in one request.

USE CASE 3

Add noise reduction to an existing audio processing pipeline without depending on the ModelScope platform.

What is it built with?

PythonFastAPIPyTorch

How does it compare?

gyj1201/zipenhancercortex-trading-systems/polymarket-copy-trading-bot-clob-aiqianchentao9/swingsr
Stars515151
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/53/55/5
Audiencedevelopergeneralresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

GPU acceleration needs an NVIDIA card with CUDA-enabled PyTorch, MP3 and OGG output require ffmpeg to be installed.

MIT license: free to use, copy, modify, and distribute, including commercially, as long as the copyright notice is kept.

So what is it?

This is a Python service that removes background noise from audio files. It takes the ZipEnhancer noise-reduction model, originally released by Alibaba's research lab via a platform called ModelScope, and reimplements the inference code in plain PyTorch so it can run without the ModelScope pipeline wrapper. The result is wrapped in a FastAPI web service that accepts audio file uploads and returns cleaned audio. The service supports three noise-reduction models switchable per request: ZipEnhancer for lightweight use, FRCRN for real-time scenarios, and MossFormer2 for higher quality output. It handles audio of any length by processing the file in four-second sliding windows with overlap, which prevents running out of GPU memory on long recordings. Stereo input produces stereo output, and the original sample rate and bit depth are preserved by default. Output can be saved as WAV, FLAC, MP3, or OGG. The API has three main endpoints: a health check, a model listing endpoint, and a denoise endpoint that accepts either a single audio file or a folder of files for batch processing. Parameters control the output format, bit rate, sample rate, and whether to apply volume normalization. GPU acceleration is supported on NVIDIA graphics cards and can reach processing speeds more than twenty times faster than real time on high-end hardware. Setup involves creating a Python 3.10 environment, installing dependencies, copying an example environment file, and starting the service with a single command. The readme and documentation are written in Chinese. The project is released under the MIT license and is aimed at developers who want to add noise reduction to audio pipelines, meeting recordings, or audio preprocessing workflows without relying on a vendor-managed model platform.

Copy-paste prompts

Prompt 1
Walk me through setting up zipEnhancer with a Python 3.10 environment and starting the FastAPI service.
Prompt 2
Explain the difference between the ZipEnhancer, FRCRN, and MossFormer2 models this service offers.
Prompt 3
Show me a curl command to denoise a single audio file and save the output as MP3 using this API.
Prompt 4
Help me batch process a folder of recordings with this service's denoise/batch endpoint.

Frequently asked questions

What is zipenhancer?

A self-hosted web service that removes background noise from audio files using three switchable AI models, with a simple upload-and-download API.

What language is zipenhancer written in?

Mainly Python. The stack also includes Python, FastAPI, PyTorch.

What license does zipenhancer use?

MIT license: free to use, copy, modify, and distribute, including commercially, as long as the copyright notice is kept.

How hard is zipenhancer to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is zipenhancer for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.