Add fart-finder: always-on flatulence detector for the DevKit

[rdyplayerB]

Fart Finder

Seismic-grade flatulence detection for the OpenHome DevKit. It listens to the room on the device microphone, recognises the sound with YAMNet (which has a literal Fart class), grades each event on a logarithmic "Ripter" scale, and warns everyone in range:

"Warning. Room-clearing event detected. Magnitude six point two. Duration one point four seconds. Open a window and be on smell lookout."

Audio never leaves the device; only event metadata reaches the cloud.

Trigger words: fart finder, fart detector, flatulence

Layout

• main.py — voice skill: status, arm, disarm, sensitivity
• background.py — cloud daemon: polls the device, interrupts, announces, runs hooks
• devkit_functions.py — device side: listener daemon (mic thread, Unix socket) and the RPC functions
• listener/ — pure signal processing plus the vendored YAMNet TFLite model (16 MB, Apache 2.0) and class map
• pi/ — install script, systemd unit, ALSA shared-capture config

Testing

• Verified end to end against the OpenHome cloud with a Mac standing in for the DevKit via Local Link: a clip fed to the listener is polled by the cloud daemon and announced by the agent in about two seconds.
• Passes validate_ability.py and the server-side upload scan.
• Not yet run on DevKit hardware. devkit_functions.py selftest reports mic, model and timing for anyone who has one.
• Detector: 88% recall on public clips, zero false alarms so far, YAMNet alone. The optional verifier head ships disabled until there is hard-negative data for it.

Notes for review

• Consent is recorded by the skill's "arm" intent rather than by the daemon, since a background daemon cannot await user input.
• All OS, file, thread and socket code lives in devkit_functions.py; the other modules are pure, which is what the upload scan requires.

🤖 Generated with Claude Code

[github-actions]

🔀 Branch Merge Check

PR direction: fart-finder → dev

✅ Passed — fart-finder → dev is a valid merge direction

[github-actions]

✅ Community PR Path Check — Passed

All changed files are inside the community/ folder. Looks good!

[github-actions]

✅ Ability Validation Passed

📋 Validating: community/fart-finder
  ✅ All checks passed!

[github-actions]

🔍 Lint Results

🔧 Formatting fixes available

This PR is from a fork, so fixes could not be pushed automatically. Download the python-lint-results artifact from the workflow run for the patch file, then run:

git apply autofix.patch

❌ __init__.py Must Be Empty

The following __init__.py files must be completely empty:

community/fart-finder/listener/__init__.py

Files linted: community/fart-finder/background.py community/fart-finder/devkit_functions.py community/fart-finder/listener/classify.py community/fart-finder/listener/copy.py community/fart-finder/listener/gate.py community/fart-finder/listener/magnitude.py community/fart-finder/listener/pipeline.py community/fart-finder/main.py

✅ Flake8 — Passed

Fix the remaining issues and push again. The lint will re-run automatically.

[uzair401]

Closing.