{"id":50419817,"url":"https://github.com/xuepoo/sonic-bridge","last_synced_at":"2026-05-31T08:00:57.609Z","repository":{"id":361150630,"uuid":"1253250964","full_name":"Xuepoo/sonic-bridge","owner":"Xuepoo","description":"An ultra-fast, lightweight, zero-pretrain-model physical music aesthetic \u0026 listening translation middleware for AI Agents \u0026 LLMs","archived":false,"fork":false,"pushed_at":"2026-05-29T11:38:19.000Z","size":109,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-29T12:24:03.950Z","etag":null,"topics":["ai-agent","audio-processing","dsp","dtw","llm","lrmd","music-analysis","musicology","onset-detection","rust"],"latest_commit_sha":null,"homepage":"https://github.com/Xuepoo/sonic-bridge","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Xuepoo.png","metadata":{"files":{"readme":"README.en.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-29T09:29:39.000Z","updated_at":"2026-05-29T11:38:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Xuepoo/sonic-bridge","commit_stats":null,"previous_names":["xuepoo/sonic-bridge"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/Xuepoo/sonic-bridge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xuepoo%2Fsonic-bridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xuepoo%2Fsonic-bridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xuepoo%2Fsonic-bridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xuepoo%2Fsonic-bridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Xuepoo","download_url":"https://codeload.github.com/Xuepoo/sonic-bridge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xuepoo%2Fsonic-bridge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33723549,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","audio-processing","dsp","dtw","llm","lrmd","music-analysis","musicology","onset-detection","rust"],"created_at":"2026-05-31T08:00:56.820Z","updated_at":"2026-05-31T08:00:57.602Z","avatar_url":"https://github.com/Xuepoo.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SonicBridge Core Audio Engine\n\n[English](README.en.md) | [简体中文](README.md)\n\nAn ultra-fast, lightweight, zero-pretrain-model physical music aesthetic \u0026 listening translation middleware designed for pure-text Large Language Models (LLMs).\n\n**SonicBridge** bridges the physical listening gap (Modal Gap) for AI Agents. It is a digital signal processing (DSP) tool written entirely in Rust, with no heavy machine learning dependencies.\n\nLeveraging high-performance audio decoding, short-time Fourier transform (STFT), Chroma pitch class projection, and Dynamic Time Warping (DTW) alignment, SonicBridge decouples raw 1D waveforms into **LRMD (LLM-Readable Music Descriptor) reports** in a fraction of a second. This empowers AI companion agents to truly \"hear\" music, sense vocal timbral emotional shifts, parse arrangement spaces, and compare Cover version performance differences.\n\n---\n\n## 🚀 Key Features\n\n*   **Zero-Model Translation**: Built entirely on classic DSP algorithms (FFT, HPSS, Chroma), yielding a statically compiled binary of only **~5MB** with zero heavy GPU or neural network runtime dependencies.\n*   **Three Aesthetic Slicing Strategies**:\n    *   **Approach A: Parameterized Adaptive Steps**: Customize temporal analysis windows via CLI or `config.toml` to track melodic changes.\n    *   **Approach B: Spectral Flux Onset-Triggered Partitioning**: Compute consecutive spectral frames positive energy flux to dynamically slice acoustic boundaries right at transient attacks (drum entries, glissandos).\n    *   **Approach C: Beat-Synchronous Resampling**: Estimate beat intervals using Autocorrelation functions, merging acoustic descriptors by musical beats.\n*   **XDG Specification Compliance**: Fully complies with **XDG Base Directory Specifications** supporting self-healing TOML configuration directories.\n*   **Cross-Version DTW Alignment**: Employs Dynamic Time Warping dual-backtracking pathfinding, enabling robust temporal alignment of Covers and Originals under non-linear tempo changes.\n*   **AI Agent Co-Listening Co-Intelligence**: Designed to seamlessly interface with CLI music players and clients. By generating standard `.lrmd.md` reports, text-only LLMs get full synesthetic ability to act as real-time musicological companions.\n\n---\n\n## 📥 Installation\n\nSonicBridge provides multiple out-of-the-box installation strategies. Select the method that best matches your system layout:\n\n### 1. Build via Cargo (Rust Ecosystem)\nIf you have a Rust toolchain configured locally, compile and install it globally via `cargo`:\n```bash\ncargo install sonic-bridge\n```\n\n### 2. Install from AUR (Arch Linux \u0026 Manjaro Users)\nStatically compiled packages are natively distributed inside the Arch User Repository:\n```bash\n# Using paru\nparu -S sonic-bridge-bin\n\n# Using yay\nyay -S sonic-bridge-bin\n```\n\n### 3. Deploy via Docker\nA minimal runtime image built using multi-stage Alpine static linking compilation is published:\n```bash\ndocker pull xuepoo/sonic-bridge:latest\n```\n\n### 4. Fetch Pre-compiled Binaries from GitHub Releases\nNavigate to the [Official GitHub Releases Page](https://github.com/Xuepoo/sonic-bridge/releases/latest) to directly fetch statically linked standalone binaries compiled for your host architecture.\n\n---\n\n## 🛠️ Quick Start\n\n### 1. Build from Source\nStatically linked, generating a single, self-contained binary without any external runtime dependencies:\n```bash\n# 1. Clone Repository\ngit clone https://github.com/Xuepoo/sonic-bridge.git\ncd sonic-bridge\n\n# 2. Compile Release Binary\ncargo build --release\n\n# 3. Run Tests\ncargo test\n```\n*(The compiled executable `./target/release/sonic-bridge` is roughly 5MB)*\n\n---\n\n### 2. CLI Usage Guide\n\n```bash\n# 1. Default 5.0-second interval analysis\nsonic-bridge \"/path/to/song.mp3\"\n\n# 2. Enable Approach B: Event-Driven Onset Adaptive Segmentation\nsonic-bridge \"/path/to/song.mp3\" --onset\n\n# 3. Load custom TOML config\nsonic-bridge \"/path/to/song.mp3\" --config \"/path/to/my_config.toml\"\n\n# 4. Cross-Version Comparative Analysis (DTW Warp)\nsonic-bridge \"/path/to/original.mp3\" \"/path/to/cover_version.mp3\"\n```\n\n---\n\n## ⚙️ XDG \u0026 Parameter Tuning (Configuration)\n\nPrioritizes loading `$XDG_CONFIG_HOME/sonic-bridge/config.toml`.\nFor detailed field explanations, XDG environment interceptions, and musical style tuning metrics, please refer to:\n👉 **[SonicConfig User \u0026 Configuration Guide (docs/configuration.md)](docs/configuration.md)**.\n\n---\n\n## 📦 Containerization \u0026 Deployment\n\n*   **Docker Registry**: Uses a multi-stage [Dockerfile](Dockerfile) to compile a minimal runtime container based on Alpine Linux:\n    ```bash\n    docker pull xuepoo/sonic-bridge:latest\n    ```\n*   **Crates.io**:\n    ```toml\n    [dependencies]\n    sonic-bridge = \"0.1\"\n    ```\n*   **GitHub Actions CI/CD**: Automatically builds multi-platform binaries, publishing to Dockerhub, crates.io, and AUR upon version tags (e.g. `v0.1.0`).\n\n---\n\n## ⚖️ License\n\nStably licensed under the [MIT License](LICENSE). Contributions, issues, and Pull Requests are welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxuepoo%2Fsonic-bridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxuepoo%2Fsonic-bridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxuepoo%2Fsonic-bridge/lists"}