{"adoption": {"forks": 83, "observed_at": "2026-08-28T04:05:14.881839+00:00", "stars": 1637}, "canonical_url": "https://ross.abutalabs.com/products/pytheory", "card": {"archived": false, "artifact_type": "library", "description": "Music Theory for Humans.", "domain": ["audio", "education", "media", "developer-tools"], "enriched": true, "function": ["audio-processing", "sdk", "developer-tools"], "health_score": 96, "homepage": "https://pytheory.org/", "language": "Python", "license": "MIT", "license_family": "permissive", "maturity": "active", "member_repos": ["kennethreitz/pytheory"], "name": "kennethreitz/pytheory", "platform": ["python", "cross-platform", "cli"], "pushed_at": "2026-07-21T12:06:19+00:00", "repo": "kennethreitz/pytheory", "stars": 1637, "tags": ["music-theory", "midi", "composition", "chords", "scales", "synthesis", "guitar", "audio-playback", "claude-plugin", "tuner", "web"], "topics": ["music-theory", "music", "scales", "python", "sympy", "hacktoberfest"], "urls": [], "use_cases": ["explore scales chords and chord progressions in python", "sketch a song with drums bass and synth parts and export midi", "identify chords and intervals from note names or chord symbols", "get guitar chord fingerings scale diagrams and nashville number charts", "tune a guitar with a real-time strobe tuner", "transcribe a hummed melody into midi or sheet music", "compose music from natural language with claude code"], "what_it_is": "PyTheory is a Python library for exploring music theory (tones, scales, chords, keys, intervals, harmony) and composing multi-part arrangements with drums, synths, and effects. It can play audio live, export to MIDI/WAV/MusicXML/tab, tune instruments, transcribe recordings, and is drivable from a Claude Code plugin.", "when_to_avoid": ["you need professional notation engraving or a full DAW production environment", "you work primarily with non-western tuning systems beyond its supported set", "you need a graphical sequencer rather than a code-first workflow"], "when_to_choose": ["you want to learn or apply music theory programmatically in python", "you want to sketch multi-part arrangements in code and export midi without a daw", "you need guitar fingerings, tablature, or tuning tools without ad-filled websites"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/pytheory", "repo": "kennethreitz/pytheory", "role": "main", "score": 90}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:05:14.881839+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T03:46:41.453853+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3349e1a37c7e10451f60920707acbfae208ddc77ecdd1ee03ac6b432ed04bfec", "fetched_at": "2026-08-28T04:05:14.881839+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kennethreitz/pytheory"}, {"content_hash": "bfbda06e9d3fc055b4f1554ecfe82423d90c77faa1e5166e12a9ca82f0954ac8", "fetched_at": "2026-08-29T11:19:56.715210+00:00", "kind": "homepage", "missing": false, "url": "https://pytheory.org/"}, {"content_hash": "f03596ffc61e73f2378d254e0225f60936e8c2b3a59b845e817229480870ecc2", "fetched_at": "2026-08-29T11:19:56.724909+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/quickstart.html"}, {"content_hash": "422bcd01b22908ae75caefb81c4a318e1919fa0e1bd4fce1819207a994f97c8e", "fetched_at": "2026-08-29T11:19:56.727585+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/claude.html"}, {"content_hash": "2fbdf78f97f08cde9e2a21c96e28de17678fdb5c90f4eeba828a582abe1fab1b", "fetched_at": "2026-08-29T11:19:56.734446+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/pytheory/json"}, {"content_hash": "83b1984752111989ad759b9331c37a0618e8f1313059c8a31580b973da89d952", "fetched_at": "2026-08-29T11:19:56.729925+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/changelog.html"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:05:14.881839+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T03:46:41.453853+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3349e1a37c7e10451f60920707acbfae208ddc77ecdd1ee03ac6b432ed04bfec", "fetched_at": "2026-08-28T04:05:14.881839+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kennethreitz/pytheory"}, {"content_hash": "bfbda06e9d3fc055b4f1554ecfe82423d90c77faa1e5166e12a9ca82f0954ac8", "fetched_at": "2026-08-29T11:19:56.715210+00:00", "kind": "homepage", "missing": false, "url": "https://pytheory.org/"}, {"content_hash": "f03596ffc61e73f2378d254e0225f60936e8c2b3a59b845e817229480870ecc2", "fetched_at": "2026-08-29T11:19:56.724909+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/quickstart.html"}, {"content_hash": "422bcd01b22908ae75caefb81c4a318e1919fa0e1bd4fce1819207a994f97c8e", "fetched_at": "2026-08-29T11:19:56.727585+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/claude.html"}, {"content_hash": "2fbdf78f97f08cde9e2a21c96e28de17678fdb5c90f4eeba828a582abe1fab1b", "fetched_at": "2026-08-29T11:19:56.734446+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/pytheory/json"}, {"content_hash": "83b1984752111989ad759b9331c37a0618e8f1313059c8a31580b973da89d952", "fetched_at": "2026-08-29T11:19:56.729925+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/changelog.html"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T03:46:41.453853+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3349e1a37c7e10451f60920707acbfae208ddc77ecdd1ee03ac6b432ed04bfec", "fetched_at": "2026-08-28T04:05:14.881839+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kennethreitz/pytheory"}, {"content_hash": "bfbda06e9d3fc055b4f1554ecfe82423d90c77faa1e5166e12a9ca82f0954ac8", "fetched_at": "2026-08-29T11:19:56.715210+00:00", "kind": "homepage", "missing": false, "url": "https://pytheory.org/"}, {"content_hash": "f03596ffc61e73f2378d254e0225f60936e8c2b3a59b845e817229480870ecc2", "fetched_at": "2026-08-29T11:19:56.724909+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/quickstart.html"}, {"content_hash": "422bcd01b22908ae75caefb81c4a318e1919fa0e1bd4fce1819207a994f97c8e", "fetched_at": "2026-08-29T11:19:56.727585+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/claude.html"}, {"content_hash": "2fbdf78f97f08cde9e2a21c96e28de17678fdb5c90f4eeba828a582abe1fab1b", "fetched_at": "2026-08-29T11:19:56.734446+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/pytheory/json"}, {"content_hash": "83b1984752111989ad759b9331c37a0618e8f1313059c8a31580b973da89d952", "fetched_at": "2026-08-29T11:19:56.729925+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/changelog.html"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:05:14.881839+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:05:14.881839+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:05:14.881839+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T03:46:41.453853+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3349e1a37c7e10451f60920707acbfae208ddc77ecdd1ee03ac6b432ed04bfec", "fetched_at": "2026-08-28T04:05:14.881839+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kennethreitz/pytheory"}, {"content_hash": "bfbda06e9d3fc055b4f1554ecfe82423d90c77faa1e5166e12a9ca82f0954ac8", "fetched_at": "2026-08-29T11:19:56.715210+00:00", "kind": "homepage", "missing": false, "url": "https://pytheory.org/"}, {"content_hash": "f03596ffc61e73f2378d254e0225f60936e8c2b3a59b845e817229480870ecc2", "fetched_at": "2026-08-29T11:19:56.724909+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/quickstart.html"}, {"content_hash": "422bcd01b22908ae75caefb81c4a318e1919fa0e1bd4fce1819207a994f97c8e", "fetched_at": "2026-08-29T11:19:56.727585+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/claude.html"}, {"content_hash": "2fbdf78f97f08cde9e2a21c96e28de17678fdb5c90f4eeba828a582abe1fab1b", "fetched_at": "2026-08-29T11:19:56.734446+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/pytheory/json"}, {"content_hash": "83b1984752111989ad759b9331c37a0618e8f1313059c8a31580b973da89d952", "fetched_at": "2026-08-29T11:19:56.729925+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/changelog.html"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:05:14.881839+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:05:14.881839+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T03:46:41.453853+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3349e1a37c7e10451f60920707acbfae208ddc77ecdd1ee03ac6b432ed04bfec", "fetched_at": "2026-08-28T04:05:14.881839+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kennethreitz/pytheory"}, {"content_hash": "bfbda06e9d3fc055b4f1554ecfe82423d90c77faa1e5166e12a9ca82f0954ac8", "fetched_at": "2026-08-29T11:19:56.715210+00:00", "kind": "homepage", "missing": false, "url": "https://pytheory.org/"}, {"content_hash": "f03596ffc61e73f2378d254e0225f60936e8c2b3a59b845e817229480870ecc2", "fetched_at": "2026-08-29T11:19:56.724909+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/quickstart.html"}, {"content_hash": "422bcd01b22908ae75caefb81c4a318e1919fa0e1bd4fce1819207a994f97c8e", "fetched_at": "2026-08-29T11:19:56.727585+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/claude.html"}, {"content_hash": "2fbdf78f97f08cde9e2a21c96e28de17678fdb5c90f4eeba828a582abe1fab1b", "fetched_at": "2026-08-29T11:19:56.734446+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/pytheory/json"}, {"content_hash": "83b1984752111989ad759b9331c37a0618e8f1313059c8a31580b973da89d952", "fetched_at": "2026-08-29T11:19:56.729925+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/changelog.html"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:05:14.881839+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:05:14.881839+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:05:14.881839+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T03:46:41.453853+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3349e1a37c7e10451f60920707acbfae208ddc77ecdd1ee03ac6b432ed04bfec", "fetched_at": "2026-08-28T04:05:14.881839+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kennethreitz/pytheory"}, {"content_hash": "bfbda06e9d3fc055b4f1554ecfe82423d90c77faa1e5166e12a9ca82f0954ac8", "fetched_at": "2026-08-29T11:19:56.715210+00:00", "kind": "homepage", "missing": false, "url": "https://pytheory.org/"}, {"content_hash": "f03596ffc61e73f2378d254e0225f60936e8c2b3a59b845e817229480870ecc2", "fetched_at": "2026-08-29T11:19:56.724909+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/quickstart.html"}, {"content_hash": "422bcd01b22908ae75caefb81c4a318e1919fa0e1bd4fce1819207a994f97c8e", "fetched_at": "2026-08-29T11:19:56.727585+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/claude.html"}, {"content_hash": "2fbdf78f97f08cde9e2a21c96e28de17678fdb5c90f4eeba828a582abe1fab1b", "fetched_at": "2026-08-29T11:19:56.734446+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/pytheory/json"}, {"content_hash": "83b1984752111989ad759b9331c37a0618e8f1313059c8a31580b973da89d952", "fetched_at": "2026-08-29T11:19:56.729925+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/changelog.html"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:05:14.881839+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:05:14.881839+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T03:46:41.453853+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3349e1a37c7e10451f60920707acbfae208ddc77ecdd1ee03ac6b432ed04bfec", "fetched_at": "2026-08-28T04:05:14.881839+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kennethreitz/pytheory"}, {"content_hash": "bfbda06e9d3fc055b4f1554ecfe82423d90c77faa1e5166e12a9ca82f0954ac8", "fetched_at": "2026-08-29T11:19:56.715210+00:00", "kind": "homepage", "missing": false, "url": "https://pytheory.org/"}, {"content_hash": "f03596ffc61e73f2378d254e0225f60936e8c2b3a59b845e817229480870ecc2", "fetched_at": "2026-08-29T11:19:56.724909+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/quickstart.html"}, {"content_hash": "422bcd01b22908ae75caefb81c4a318e1919fa0e1bd4fce1819207a994f97c8e", "fetched_at": "2026-08-29T11:19:56.727585+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/claude.html"}, {"content_hash": "2fbdf78f97f08cde9e2a21c96e28de17678fdb5c90f4eeba828a582abe1fab1b", "fetched_at": "2026-08-29T11:19:56.734446+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/pytheory/json"}, {"content_hash": "83b1984752111989ad759b9331c37a0618e8f1313059c8a31580b973da89d952", "fetched_at": "2026-08-29T11:19:56.729925+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/changelog.html"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T03:46:41.453853+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3349e1a37c7e10451f60920707acbfae208ddc77ecdd1ee03ac6b432ed04bfec", "fetched_at": "2026-08-28T04:05:14.881839+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kennethreitz/pytheory"}, {"content_hash": "bfbda06e9d3fc055b4f1554ecfe82423d90c77faa1e5166e12a9ca82f0954ac8", "fetched_at": "2026-08-29T11:19:56.715210+00:00", "kind": "homepage", "missing": false, "url": "https://pytheory.org/"}, {"content_hash": "f03596ffc61e73f2378d254e0225f60936e8c2b3a59b845e817229480870ecc2", "fetched_at": "2026-08-29T11:19:56.724909+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/quickstart.html"}, {"content_hash": "422bcd01b22908ae75caefb81c4a318e1919fa0e1bd4fce1819207a994f97c8e", "fetched_at": "2026-08-29T11:19:56.727585+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/claude.html"}, {"content_hash": "2fbdf78f97f08cde9e2a21c96e28de17678fdb5c90f4eeba828a582abe1fab1b", "fetched_at": "2026-08-29T11:19:56.734446+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/pytheory/json"}, {"content_hash": "83b1984752111989ad759b9331c37a0618e8f1313059c8a31580b973da89d952", "fetched_at": "2026-08-29T11:19:56.729925+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/changelog.html"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T03:46:41.453853+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3349e1a37c7e10451f60920707acbfae208ddc77ecdd1ee03ac6b432ed04bfec", "fetched_at": "2026-08-28T04:05:14.881839+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kennethreitz/pytheory"}, {"content_hash": "bfbda06e9d3fc055b4f1554ecfe82423d90c77faa1e5166e12a9ca82f0954ac8", "fetched_at": "2026-08-29T11:19:56.715210+00:00", "kind": "homepage", "missing": false, "url": "https://pytheory.org/"}, {"content_hash": "f03596ffc61e73f2378d254e0225f60936e8c2b3a59b845e817229480870ecc2", "fetched_at": "2026-08-29T11:19:56.724909+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/quickstart.html"}, {"content_hash": "422bcd01b22908ae75caefb81c4a318e1919fa0e1bd4fce1819207a994f97c8e", "fetched_at": "2026-08-29T11:19:56.727585+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/claude.html"}, {"content_hash": "2fbdf78f97f08cde9e2a21c96e28de17678fdb5c90f4eeba828a582abe1fab1b", "fetched_at": "2026-08-29T11:19:56.734446+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/pytheory/json"}, {"content_hash": "83b1984752111989ad759b9331c37a0618e8f1313059c8a31580b973da89d952", "fetched_at": "2026-08-29T11:19:56.729925+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/changelog.html"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T03:46:41.453853+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "3349e1a37c7e10451f60920707acbfae208ddc77ecdd1ee03ac6b432ed04bfec", "fetched_at": "2026-08-28T04:05:14.881839+00:00", "kind": "readme", "missing": false, "url": "https://github.com/kennethreitz/pytheory"}, {"content_hash": "bfbda06e9d3fc055b4f1554ecfe82423d90c77faa1e5166e12a9ca82f0954ac8", "fetched_at": "2026-08-29T11:19:56.715210+00:00", "kind": "homepage", "missing": false, "url": "https://pytheory.org/"}, {"content_hash": "f03596ffc61e73f2378d254e0225f60936e8c2b3a59b845e817229480870ecc2", "fetched_at": "2026-08-29T11:19:56.724909+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/quickstart.html"}, {"content_hash": "422bcd01b22908ae75caefb81c4a318e1919fa0e1bd4fce1819207a994f97c8e", "fetched_at": "2026-08-29T11:19:56.727585+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/guide/claude.html"}, {"content_hash": "2fbdf78f97f08cde9e2a21c96e28de17678fdb5c90f4eeba828a582abe1fab1b", "fetched_at": "2026-08-29T11:19:56.734446+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/pytheory/json"}, {"content_hash": "83b1984752111989ad759b9331c37a0618e8f1313059c8a31580b973da89d952", "fetched_at": "2026-08-29T11:19:56.729925+00:00", "kind": "site_page", "missing": false, "url": "https://pytheory.org/changelog.html"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 93, "longevity": 100, "rhythm": 80}, "computed_at": "2026-09-03T02:39:23.370411+00:00", "flags": [], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 2926, "days_push": 43, "days_rel": 57, "gap_med": 0, "n_releases_24m": 84}, "score": 90, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}