Skip to content

docs(build): note optional setup-deepfilter.sh prereq for local DFNR#4282

Open
ten9876 wants to merge 1 commit into
mainfrom
docs/dfnr-local-setup-note
Open

docs(build): note optional setup-deepfilter.sh prereq for local DFNR#4282
ten9876 wants to merge 1 commit into
mainfrom
docs/dfnr-local-setup-note

Conversation

@ten9876

@ten9876 ten9876 commented Jul 17, 2026

Copy link
Copy Markdown
Collaborator

What

Adds a short note to the Build section of AGENTS.md documenting the optional scripts/setup/setup-deepfilter.sh step that enables DFNR (DeepFilterNet3) noise reduction for local dev builds.

Why

On a clean checkout, CMake configure reports:

DFNR (DeepFilterNet3) disabled — library not found ... (run ./scripts/setup/setup-deepfilter.sh before cmake to enable)

CI already runs this setup step automatically (cached) in every build workflow — ci.yml, macos-dmg.yml, appimage.yml, windows-installer.yml — so release binaries always ship DFNR. The only gap was the local dev path, where the step was undocumented in AGENTS.md / README / CONTRIBUTING and surfaced only via the configure message. This documents it (including the Windows .ps1 variant) and clarifies NR still works without it via NR4 (libspecbleach).

Docs-only; no code or CI changes.

🤖 Generated with Claude Code

CMake gates DFNR off with "library not found" when the prebuilt
libdeepfilter isn't present. CI fetches it automatically (cached) in
every build workflow, so this trips up only local dev builds. Document
the one-time setup step (and Windows .ps1 variant) in the Build section.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@ten9876
ten9876 requested a review from a team as a code owner July 17, 2026 20:13
@NF0T

NF0T commented Jul 18, 2026

Copy link
Copy Markdown
Collaborator

Verified the factual claims directly rather than a full review pass, since there's no logic here to test -- this is docs-only:

  • scripts/setup/setup-deepfilter.sh and setup-deepfilter.ps1 both exist.
  • CMake's message matches exactly: "DFNR (DeepFilterNet3) disabled -- library not found at ${DFNR_LIB}...".
  • All four workflows named (ci.yml, macos-dmg.yml, appimage.yml, windows-installer.yml) do reference setup-deepfilter.

Everything checks out, CI is green. Nothing to request changes on.

One process note, not about this PR's content: this touches AGENTS.md, which CODEOWNERS routes specifically to @aethersdr/maintainers (overriding the broader Tier 3 default), and you're currently the sole member of that team. GitHub hard-blocks self-approval regardless of team membership, so as it stands nobody -- including us -- can satisfy that gate to merge this. Worth knowing for any future AGENTS.md-only PR you author yourself, not just this one.

@NF0T NF0T self-assigned this Jul 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants