DSP Agent Aligner

🎙️ DSP-Agent-Aligner (DAA)

   

**DSP-Agent-Aligner (DAA)** is a robust GUI infrastructure built for the AI-assisted audio programming era. It bridges the gap between your physical local audio hardware and LLM-based coding agents (like Cursor, Trae, or Claude).

Writing cross-platform audio code (like `pyo` or `sounddevice`) on Windows often leads to silent crashes, ghost WASAPI devices, and channel-mismatch errors. Worse, AI coding agents suffer from **"hardware hallucinations"**—blindly writing full-duplex audio code without knowing your local soundcard's actual topology.

**DAA solves this.** It provides a safe, non-blocking GUI to test your physical audio endpoints, safely hot-patches your project's configuration via AST, and instantly generates a deterministic `JSON Schema Context` to inject into your LLM prompt, ensuring **Zero-Hallucination** human-agent collaborative DSP programming.

---

✨ Key Features

• 🛡️ Safe Device Routing & Filtering: Intelligently bypasses Windows WASAPI "0-channel ghost device" traps. Accurately calculates true is_duplex_supported flags to prevent PortAudio [Errno -9998] Invalid number of channels crashes.
• 🔊 Embodied Auditory Test Loop: Features a thread-safe, non-blocking sounddevice test loop. Validates physical audio output without freezing the GUI or locking up the OS audio bus.
• 📝 AST Hot-Patching: Safely injects the tested TARGET_DEVICE_ID and SAMPLE_RATE directly into your target project's config.py using Abstract Syntax Trees (AST). No regex breaking your code format, no OS file-locking deadlocks.
• 🤖 Zero-Hallucination Agent Contract: Translates your physical hardware limits into a strict JSON Sc