earshot

Ears for coding agents: let AI hear, review and make sound. CPU-only, open source.

What is earshot?

Ears for coding agents: let AI hear, review and make sound. CPU-only, open source.

Overview of earshot

What it is

Earshot is a CPU-only, open-source tool that gives AI coding agents the ability to hear, review, and make sound. It runs locally as a CLI, a Python API, and an MCP server. It turns sound into evidence an agent can reason about: what a file sounds like in words, how well it fits a description, the best moment inside a long recording, whether it is a real recording or code-synthesized, a second-by-second listening transcript of a whole film, an annotated picture of it, and a scorecard against professional launch films.

Key features

  • Provides commands to describe, match, rank, find, compare, measure, critique, and generate sound.
  • Includes a bank of 252 sound effects stored as code, renderable by ID with no models and no network.
  • Forge command lets an agent write a sound as a recipe of physical synthesis and improve it by listening.
  • Fit command translates a recording into a forge recipe that can be varied.
  • Sheet command produces an annotated PNG with video frames, labelled events, spectrogram, waveform, loudness, and sync markers.
  • Runs entirely on CPU; no GPU required.

Use cases

AI coding agents that need to evaluate or generate sound for films, product demos, or games. Sound designers who want to iterate on synthesized sounds by listening. Automated quality checking of audio against reference profiles.

Getting started

See the repository README for installation instructions.

License and pricing

MIT license, open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/leonxlnxearshot.svg)](https://yunodb.com/tools/leonxlnxearshot?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/leonxlnxearshot?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/leonxlnxearshot.svg" alt="Featured on YunoDB" height="20"></a>