NoiseGuard

DSP noise reduction using bandpass filtering and noise-profile subtraction.

📖 Overview

NoiseGuard profiles background noise from a quiet segment and subtracts it, then applies a voice-band bandpass filter to clean up audio before it enters the pipeline.

Built on the "Antigravity" model.

🚀 Quick Start

# 1. Clone
git clone https://github.com/Kimosabey/noise-guard.git
cd noise-guard

# 2. Install
# (see docs/GETTING_STARTED.md for the full setup)

# 3. Run
docker compose up

✨ Key Features

• Bandpass filtering tuned to the voice band
• Noise-profile capture and subtraction
• Lightweight, streaming-friendly DSP
• Complements the separation model in ClearVoice

🏗️ Architecture

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#ffffff','lineColor':'#2563eb','mainBkg':'#ffffff'}}}%%
graph LR
    A([Audio])
    B([Bandpass Filter])
    C([Noise-Profile Subtraction])
    D([Clean Audio])
    A --> B
    B --> C
    C --> D
    style A fill:#eff6ff,stroke:#2563eb,stroke-width:2px,color:#1e40af
    style B fill:#eff6ff,stroke:#2563eb,stroke-width:2px,color:#1e40af
    style C fill:#eff6ff,stroke:#2563eb,stroke-width:2px,color:#1e40af
    style D fill:#eff6ff,stroke:#2563eb,stroke-width:2px,color:#1e40af

Loading

Classic signal processing done right — real filters and spectral subtraction rather than a black-box model.

See docs/ARCHITECTURE.md for the full HLD/LLD and design decisions.

🧰 Tech Stack

Layer	Technology	Role
Node.js	Node.js	Application runtime / service layer
FFmpeg	FFmpeg	Audio/video signal processing

📚 Documentation

• Architecture — high- and low-level design, decision log
• Getting Started — prerequisites, setup, environment
• Failure Scenarios — fault analysis and recovery
• Interview Q&A — deep-dive walkthrough

🔭 Future Enhancements

• Adaptive noise profiling
• Real-time mode
• Configurable filter bands

📄 License

Released under the MIT License.

👤 Author

Harshan Aiyappa Senior Full-Stack Hybrid AI Engineer Voice AI • Distributed Systems • Infrastructure