TYEclipse/dsh-musictheory

README excerpt

dsh-musictheory 🎼 Deterministic music theory math for DeepSeek Harness ( dsh ) — zero runtime dependencies, pure 12-TET arithmetic. 中文简介 ：音乐理论数学工具箱——解析音名、频率与 MIDI 互转、26 种和弦的正确拼写（G 大三和弦是 G B D 而非 G C D ）、17 种音阶的生成（F 大调含 E ）。零运行时依赖、纯确定计算，专治大模型手算音高/升降号/同音异名的高频错误。 Why Agents get music theory wrong in predictable ways: - C4 frequency? Often quoted wrong — it's exactly 440 · 2^((60−69)/12) = 261.625565… Hz . - G major chord? Frequently written G C D — the correct spelling is G B D (a major third above G is B , the leading tone, not C). - F major scale? Usually missing the E (six sharps, not five). - Bb vs A ? Same key on the piano, different meaning on paper — the tools list all conventional enharmonic spellings. These tools replace all of that with deterministic tables and a spelling engine. Tools Tool What it does note info Parse a note name ( C 4 , Bb3 , B 4 , F 4 , Gx4 ) → MIDI number, octave, pitch class, exact 12-TET frequency, and all conventional enharmonic spellings. freq to note Frequency in Hz → nearest note, MIDI number, cents deviation, enharmonics. chord build Correctly spelled chords for 26 qualities — maj , min , dim , aug , sus2 , sus4 , 5 , 6 , m6 , 7 , maj7 , m7 , m7b…

Category