Pre-release

This release is a pre-release and may not be stable for production use.

Supriya

Supriya is a Python API for SuperCollider.

Supriya lets you:

Boot and communicate with SuperCollider's synthesis engine in realtime.
Explore nonrealtime composition with scores.
Compile SuperCollider SynthDefs natively in Python code
Build time-agnostic asyncio-aware applications with the context interface.
Schedule patterns and callbacks with tempo- and meter-aware clocks
Integrate with IPython, Sphinx and Graphviz

Quickstart

1. Get Supriya

Install from PyPI:

pip install supriya

Or from source:

git clone https://github.com/supriya-project/supriya.git
cd supriya
pip install -e .

2. Get SuperCollider

Get SuperCollider from http://supercollider.github.io/.

3. Boot the server

Start your Python interpreter and import Supriya:

>>> import supriya

Boot the SuperCollider server:

>>> server = supriya.Server().boot()

4. Build a SynthDef

Import some classes:

>>> from supriya import Envelope, synthdef
>>> from supriya.ugens import EnvGen, Out, SinOsc

Make a synthesizer definition:

>>> @synthdef()
... def simple_sine(frequency=440, amplitude=0.1, gate=1):
...     sine = SinOsc.ar(frequency=frequency) * amplitude
...     envelope = EnvGen.kr(envelope=Envelope.adsr(), gate=gate, done_action=2)
...     Out.ar(bus=0, source=[sine * envelope] * 2)
...

Visualize the SynthDef (requires Graphviz):

>>> supriya.graph(simple_sine)

Allocate it on the server:

>>> _ = server.add_synthdefs(simple_sine)

... and then sync the server before proceeding to ensure the SynthDef has been fully parsed by scsynth:

>>> _ = server.sync()

5. Create some nodes

Create and allocate a group:

>>> group = server.add_group()

Create some synthesizers with the previously defined synthesizer definition, and allocate them on the server as a child of the previously created group:

>>> for i in range(3):
...     _ = group.add_synth(simple_sine, frequency=111 * (i + 1))
...

Query the server's node tree:

>>> print(server.query_tree())
NODE TREE 0 group
    1 group
        1000 group
            1003 simple_sine
                amplitude: 0.1, frequency: 333.0, gate: 1.0
            1002 simple_sine
                amplitude: 0.1, frequency: 222.0, gate: 1.0
            1001 simple_sine
                amplitude: 0.1, frequency: 111.0, gate: 1.0

6. Release and quit

Release the synths:

>>> for synth in group.children[:]:
...     synth.free()
...

Quit the server:

>>> server.quit()

License

This library is made available under the terms of the MIT license.

Metadata

Release files for supriya 26.9b1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for supriya 26.9b1
File	Size	Uploaded
supriya-26.9b1.tar.gz	3.4 MB	Sep 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for supriya 26.9b1
File	Interpreter	ABI	Platform	Reset
supriya-26.9b1-py3-none-any.whl 958.0 kB Sep 10, 2026	Python 3	none	any	Details

Total release size: 4.4 MB

Release files / supriya-26.9b1.tar.gz

Download URL	supriya-26.9b1.tar.gz
Size	3.4 MB
Tags	Source
SHA-256 checksum How to use checksums	`ca7bbe7949e4e60b9c4f4c7caf51c0e55abec2903c7ceb736e4fbe63aaf24833`
BLAKE2b-256 checksum How to use checksums	`398d9adcbe22839d52c91e1182514d12fbe95fa33e639f4b8eead9bbe45b9fae`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/supriya-project/supriya
Publishing commit: github.com/supriya-project/supriya/tree/d2039e1886066feeab1a7d118cc5be3c2fcf6531

Workflow

Publishing configuration: github.com/supriya-project/supriya/blob/d2039e1886066feeab1a7d118cc5be3c2fcf6531/.github/workflows/publish.yml
Publishing logs: github.com/supriya-project/supriya/actions/runs/34534410803/attempts/1

Artifact

Subject: supriya-26.9b1.tar.gz
SHA-256 checksum: ca7bbe7949e4e60b9c4f4c7caf51c0e55abec2903c7ceb736e4fbe63aaf24833 Verifying attestations

Release files / supriya-26.9b1-py3-none-any.whl

Download URL	supriya-26.9b1-py3-none-any.whl
Size	958.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`93e00ad960e7aa635421edc982f241f2b4b7663a81ec865e88344eb02d47694a`
BLAKE2b-256 checksum How to use checksums	`4c6b7a9cc0800f0cc3f7b3771e90ac265e6eed22630715fedfdbfe517443b868`
Upload date	Sep 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/supriya-project/supriya
Publishing commit: github.com/supriya-project/supriya/tree/d2039e1886066feeab1a7d118cc5be3c2fcf6531

Workflow

Publishing configuration: github.com/supriya-project/supriya/blob/d2039e1886066feeab1a7d118cc5be3c2fcf6531/.github/workflows/publish.yml
Publishing logs: github.com/supriya-project/supriya/actions/runs/34534410803/attempts/1

Artifact

Subject: supriya-26.9b1-py3-none-any.whl
SHA-256 checksum: 93e00ad960e7aa635421edc982f241f2b4b7663a81ec865e88344eb02d47694a Verifying attestations