Guía
Instala AI Noise Remover SDK
Esta guía instala AI Noise Remover SDK, comprueba que funciona y elimina el ruido de tu primera grabación. Tarda unos diez minutos y todo se ejecuta en tu propio ordenador.
1Comprueba lo que necesitas
Necesitas Python 3.11, 3.12, 3.13 o 3.14 y FFmpeg, que incluye FFprobe. La edición para JavaScript necesita Node.js 22 o 24 en lugar de Python. No hace falta tarjeta gráfica: el modelo de voz funciona en la CPU.
python3 --version ffmpeg -versionEn Windows, usa
py --version. Si no tienes Python, instálalo desde python.org y, en Windows, marca «Add python.exe to PATH».2Instala FFmpeg
En macOS con Homebrew:
brew install ffmpegEn Ubuntu o Debian:
sudo apt-get install ffmpegEn Windows:
winget install --id Gyan.FFmpegCierra la terminal y abre una nueva para que encuentre el programa; después, vuelve a ejecutar
ffmpeg -version.3Instala el SDK en un entorno virtual
Un entorno virtual separa el SDK y sus dependencias de tus otros proyectos de Python. En macOS y Linux:
python3 -m venv .venv source .venv/bin/activate python -m pip install loudness-audio-kitEn Windows, en PowerShell:
py -m venv .venv .venv\Scripts\activate python -m pip install loudness-audio-kit4Comprueba la instalación
loudness-audio processing-doctorEl comando muestra un informe JSON.
"ready": truey"speech_engine": "ready"indican que se encontró FFmpeg y que el modelo de voz se carga.5Elimina el ruido de tu primera grabación
loudness-audio denoise grabacion.wav --output limpia.wav --progressUsa
enhanceen lugar dedenoisepara reducir también los graves molestos, comprimir con suavidad y normalizar la sonoridad, por ejemplo para un pódcast:loudness-audio enhance podcast.mp3 --output podcast-limpio.wav --target-lufs -16Lo mismo desde Python:
from loudness_audio_kit import denoise, enhance denoise("grabacion.wav", "limpia.wav") enhance("podcast.mp3", "podcast-limpio.wav", target_lufs=-16)6Opcional: compila la edición para JavaScript y TypeScript
La edición para Node.js se compila desde el repositorio de GitHub:
git clone https://github.com/Loudness-ai/ai-noise-remover-sdk.git cd ai-noise-remover-sdk/javascript npm ci --ignore-scripts npm run build node dist/cjs/cli.js processing-doctor7Opcional: ejecuta la demo web local
El repositorio incluye una pequeña página web para subir, procesar y descargar audio en tu propio equipo. Desde la carpeta
javascript, después de compilar:npm ci --prefix demo --ignore-scripts npm run demoDespués, abre
http://127.0.0.1:7860/. La guía de la demo en GitHub explica cómo usarla con Docker.
Problemas habituales
No se encuentra FFmpeg
Instala FFmpeg como en el paso 2 y abre una terminal nueva. En Windows, comprueba que ffmpeg -version funciona en la ventana nueva antes de usar el SDK.
«loudness-audio» no se reconoce
Activa primero el entorno virtual (paso 3). Cada terminal nueva necesita source .venv/bin/activate, o .venv\Scripts\activate en Windows.
pip no encuentra una versión compatible
El SDK necesita Python 3.11 a 3.14. Comprueba python --version y crea el entorno con una versión compatible, por ejemplo py -3.12 -m venv .venv en Windows.
PowerShell no deja activar el entorno
Ejecuta una vez Set-ExecutionPolicy -Scope CurrentUser RemoteSigned y vuelve a activarlo.
La música suena peor después de procesarla
El modelo de voz está pensado para grabaciones de voz y puede suprimir la música. Para música, usa normalize, que solo cambia la sonoridad.
Siguientes pasos
Más guías
- Instala loudness-ttsPython o JavaScript en Windows, macOS y Linux, primera voz con subtítulos, el servidor de voz, Docker y uso sin conexión.
- Texto a voz local y gratuito para Open WebUILee en voz alta las respuestas de Open WebUI con voces naturales que funcionan en tu propio equipo.
- Texto a voz local y gratuito para LibreChatConfigura librechat.yaml para que LibreChat lea los mensajes en voz alta con voces locales gratuitas.
- Texto a voz local y gratuito para AnythingLLMUsa el proveedor OpenAI Compatible de AnythingLLM con voces gratuitas en tu propio equipo.