{"id":32989198,"url":"https://github.com/supriya-project/supriya","last_synced_at":"2026-01-14T08:35:53.176Z","repository":{"id":14742340,"uuid":"17463359","full_name":"supriya-project/supriya","owner":"supriya-project","description":"A Python API for SuperCollider","archived":false,"fork":false,"pushed_at":"2025-12-14T21:54:37.000Z","size":112370,"stargazers_count":373,"open_issues_count":15,"forks_count":36,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-12-26T08:48:01.996Z","etag":null,"topics":["audio","composition","dsp","music","python","sc","supercollider","synthesis","synthesizer"],"latest_commit_sha":null,"homepage":"http://supriya-project.github.io/supriya","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/supriya-project.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2014-03-06T02:27:25.000Z","updated_at":"2025-12-25T17:15:32.000Z","dependencies_parsed_at":"2024-01-17T02:59:14.770Z","dependency_job_id":"c3e7c22f-6898-4d13-b014-baf60551b82b","html_url":"https://github.com/supriya-project/supriya","commit_stats":null,"previous_names":["supriya-project/supriya","josiah-wolf-oberholtzer/supriya"],"tags_count":62,"template":false,"template_full_name":null,"purl":"pkg:github/supriya-project/supriya","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supriya-project%2Fsupriya","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supriya-project%2Fsupriya/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supriya-project%2Fsupriya/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supriya-project%2Fsupriya/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/supriya-project","download_url":"https://codeload.github.com/supriya-project/supriya/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supriya-project%2Fsupriya/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28414527,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T08:31:27.429Z","status":"ssl_error","status_checked_at":"2026-01-14T08:31:19.098Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","composition","dsp","music","python","sc","supercollider","synthesis","synthesizer"],"created_at":"2025-11-13T09:00:21.151Z","updated_at":"2026-01-14T08:35:53.146Z","avatar_url":"https://github.com/supriya-project.png","language":"Python","funding_links":[],"categories":["Libraries and tools"],"sub_categories":[],"readme":"# Supriya\n\n[![](https://img.shields.io/pypi/pyversions/supriya)]()\n[![](https://img.shields.io/pypi/l/supriya)]()\n[![](https://img.shields.io/github/actions/workflow/status/supriya-project/supriya/test.yml?branch=main)]()\n\n[Supriya](https://github.com/supriya-project/supriya) is a\n[Python](https://www.python.org/) API for\n[SuperCollider](http://supercollider.github.io/).\n\nSupriya lets you:\n\n- Boot and communicate with SuperCollider's synthesis engine\n  in [realtime](http://supriya-project.github.io/supriya/api/supriya/contexts/realtime.html).\n\n- Explore\n  [nonrealtime](http://supriya-project.github.io/supriya/api/supriya/contexts/nonrealtime.html)\n  composition with scores.\n\n- Compile SuperCollider\n  [SynthDefs](http://supriya-project.github.io/supriya/api/supriya/ugens/index.html)\n  natively in Python code\n\n- Build time-agnostic\n  [asyncio](https://docs.python.org/3/library/asyncio.html)-aware applications\n  with the\n  [context](http://supriya-project.github.io/supriya/api/supriya/contexts/core.html)\n  interface.\n\n- Schedule\n  [patterns](http://supriya-project.github.io/supriya/api/supriya/patterns/index.html)\n  and callbacks with tempo- and meter-aware\n  [clocks](http://supriya-project.github.io/supriya/api/supriya/clocks/index.html)\n\n- Integrate with [IPython](http://ipython.org/),\n  [Sphinx](https://www.sphinx-doc.org/en/master/) and\n  [Graphviz](http://graphviz.org/)\n\n## Quickstart\n\n### 1. Get Supriya\n\nInstall from PyPI:\n\n    pip install supriya\n\nOr from source:\n\n    git clone https://github.com/supriya-project/supriya.git\n    cd supriya\n    pip install -e .\n\n### 2. Get SuperCollider\n\nGet SuperCollider from http://supercollider.github.io/.\n\n### 3. Boot the server\n\nStart your Python interpreter and import Supriya:\n\n    \u003e\u003e\u003e import supriya\n\nBoot the SuperCollider server:\n\n    \u003e\u003e\u003e server = supriya.Server().boot()\n\n### 4. Build a SynthDef\n\nImport some classes:\n\n    \u003e\u003e\u003e from supriya import Envelope, synthdef\n    \u003e\u003e\u003e from supriya.ugens import EnvGen, Out, SinOsc\n\nMake a synthesizer definition:\n\n    \u003e\u003e\u003e @synthdef()\n    ... def simple_sine(frequency=440, amplitude=0.1, gate=1):\n    ...     sine = SinOsc.ar(frequency=frequency) * amplitude\n    ...     envelope = EnvGen.kr(envelope=Envelope.adsr(), gate=gate, done_action=2)\n    ...     Out.ar(bus=0, source=[sine * envelope] * 2)\n    ...\n\nVisualize the SynthDef (requires [Graphviz](http://graphviz.org/)):\n    \n    \u003e\u003e\u003e supriya.graph(simple_sine)\n\n\u003cimg src=\"./graph.svg\"\u003e\n\nAllocate it on the server:\n\n    \u003e\u003e\u003e _ = server.add_synthdefs(simple_sine)\n\n... and then sync the server before proceeding to ensure the SynthDef has been\nfully parsed by scsynth:\n\n    \u003e\u003e\u003e _ = server.sync()\n\n### 5. Create some nodes\n\nCreate and allocate a group:\n\n    \u003e\u003e\u003e group = server.add_group()\n\nCreate some synthesizers with the previously defined synthesizer definition, and\nallocate them on the server as a child of the previously created group:\n\n    \u003e\u003e\u003e for i in range(3):\n    ...     _ = group.add_synth(simple_sine, frequency=111 * (i + 1))\n    ...\n\nQuery the server's node tree:\n\n    \u003e\u003e\u003e print(server.query_tree())\n    NODE TREE 0 group\n        1 group\n            1000 group\n                1003 simple_sine\n                    amplitude: 0.1, frequency: 333.0, gate: 1.0\n                1002 simple_sine\n                    amplitude: 0.1, frequency: 222.0, gate: 1.0\n                1001 simple_sine\n                    amplitude: 0.1, frequency: 111.0, gate: 1.0\n\n### 6. Release and quit\n\nRelease the synths:\n\n    \u003e\u003e\u003e for synth in group.children[:]:\n    ...     synth.free()\n    ...\n\nQuit the server:\n\n    \u003e\u003e\u003e server.quit()\n\n## License\n\nThis library is made available under the terms of the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupriya-project%2Fsupriya","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsupriya-project%2Fsupriya","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupriya-project%2Fsupriya/lists"}