rlx-aec 0.2.11

Acoustic echo cancellation (FDAF-NLMS + RLX residual suppression) at 16 kHz
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

# rlx-aec

Pure Rust acoustic echo cancellation at **16 kHz mono** — FDAF overlap-save NLMS (`rustfft` via `rlx-fft`) plus optional per-bin RLX residual suppression.

Pre-ASR front-end: feed cleaned PCM to Whisper / Voxtral unchanged.

## CLI

```bash
cargo run -p rlx-aec --release -- \
  --mic-wav echoed_mic.wav \
  --ref-wav speaker_ref.wav \
  --out-wav cleaned.wav
```

Flags: `--step-size`, `--max-delay-ms`, `--no-residual`.

## Library

```rust
use rlx_aec::{AecConfig, AecSession};

let mut aec = AecSession::new(AecConfig::default())?;
let clean = aec.process(&mic_chunk, &far_end_chunk)?;
```

Duplex: `aec.push_reference(tts_pcm)` on playback; `aec.process_mic(mic_chunk)` on capture.

## Bench

```bash
just test-aec
just bench-aec
just bench-aec-parity   # Rust echo_bench + Python NLMS baseline
```

## Weights

Embedded `weights/residual_aec.safetensors` (identity mask v1). Regenerate:

```bash
python3 scripts/aec_synthetic_dataset.py --out-dir /tmp/aec_dataset
python3 scripts/aec_train_residual_export.py --dataset-dir /tmp/aec_dataset \
  --out crates/rlx-aec/weights/residual_aec.safetensors
```

## Tests

| Test | What |
|------|------|
| `synthetic_echo` | Delay, FDAF MSE improvement, session offline |
| `fdaf_parity` | vs `fdaf-aec` crate (dev-dep) |
| `whisper_e2e` | `RLX_WHISPER_DIR` + JFK echo fixture |