Pebble Piano

Pebble Piano is a Mac piano tutor that listens to you play and teaches from what it hears. Learning piano alone is hard because nobody tells you what went wrong or what to practise next, and most apps only teach from their own song catalog. Pebble Piano works with the books people already own. Import a PDF music book, pick a piece, and Muse Wonder reads the printed notation so the page becomes a playable, gradable lesson. Pebble Piano checks the reading and flags bars for review, so you can fix them before practising. As you play on a MIDI keyboard, an acoustic piano through the Mac's microphone, or the computer keyboard, on-device code grades each take against the score: right, wrong, missed and extra notes, plus rhythm and tempo. A Muse Spark tutor then coaches from those measurements, not guesses: it explains what went wrong, which bar to drill and what to practise next, plans a lesson for the piece, and makes exercises. Piano audio never leaves the Mac. Built during the hackathon (everything after the `hackathon-start` tag on the `hackathon` branch): the Meta model client, PDF book import and reading with Muse Wonder, the Muse Spark tutor chat, lesson planning and generated exercises, and the ear-training and sight-reading courses. Built before the hackathon: the core grader, MIDI and microphone note detection, and the early lessons and learner profiles.