PyPI version Python 3.10+ License: CC BY-SA 4.0

Klotho

Klotho, from the Ancient Greek κλώθω (klṓthō), meaning "to spin." The mythological figure Clotho, one of the three Fates, takes her name from this same word.

Klotho is an open source computer-assisted composition toolkit implemented in Python. It is designed to work in tandem with external synthesis applications and as a resource for the methods and models associated with musical abstraction and computation.

Klotho adapts to multiple Python workflows, supporting traditional scripting, interactive notebook environments, and immediate computational tasks through the interpreter.

Companion Book

An interactive Jupyter Book exploring the theory, mathematics, and CAC practice behind Klotho. This is a work in progress, but will ultimately cover such topics as foundational graph structures, formal grammars, evolutionary algorithms, quantum fields, and beyond.

Readable directly in your browser with no installation required.

Read online: https://kr4g.github.io/klotho-book/

Installation

Option 1: Install from PyPI (Recommended)

pip install klotho-cac

That's it. You're ready to go.

Option 2: Install from Source

Clone the repository to get a local copy of the Klotho source code, then install in editable mode:

git clone https://github.com/kr4g/Klotho.git
cd Klotho/
pip install -e .

Editable mode (-e) means changes you make to the source are immediately reflected without reinstalling.

For contributors: To also install testing and documentation tools, run pip install -e .[dev] instead.

Integration with SuperCollider

To use Klotho with SuperCollider, see the Klotho-SC extension package: https://github.com/kr4g/Klotho-SC.git.

Documentation

📖 Online Documentation: https://klotho.readthedocs.io/

The complete documentation is available online and includes:

  • Complete API reference for all modules
  • Usage examples and tutorials
  • NumPy-style docstring documentation

🛠️ Build Documentation Locally (Optional):

For developers who want to build the documentation locally or preview changes:

pip install klotho-cac[docs]
cd docs
make dev

License

Klotho © 2023–2026 by Ryan Millett is licensed under CC BY-SA 4.0.

CC Icon BY Icon SA Icon

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (10.18.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for kr4g from gravatar.com kr4g

Credits

Author: Ryan Millett

License

Other/Proprietary License (CC-BY-SA-4.0)

Requires

Python >=3.11

Provides Extra

playback sampling docs dev

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

klotho_cac-10.8.0.tar.gz (1.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

klotho_cac-10.8.0-py3-none-any.whl (1.9 MB view details)

Uploaded Python 3

File details

Details for the file klotho_cac-10.8.0.tar.gz.

File metadata

  • Download URL: klotho_cac-10.8.0.tar.gz
  • Upload date:
  • Size: 1.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for klotho_cac-10.8.0.tar.gz
Algorithm Hash digest
SHA256 6607667b7b19eb21837ac1bc91d628da86a70f8f463c4087b73f4837155d7d36
MD5 1563edba274e177c93a423e66dd19edd
BLAKE2b-256 fb333028684cae2878ad8aa017c07d2ffd5bd8ecd748d9fe8a47da84831c761b

See more details on using hashes here.

File details

Details for the file klotho_cac-10.8.0-py3-none-any.whl.

File metadata

  • Download URL: klotho_cac-10.8.0-py3-none-any.whl
  • Upload date:
  • Size: 1.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for klotho_cac-10.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 52781728cdfb16bdf43053740a5df767da9f39c632e700fd1d48d717424e40d7
MD5 a8ca8018c4f1662200b8d9e9ac783d31
BLAKE2b-256 144bd651fbbb94c708127b830528f84b1834073072570dc986263c28c29dcbc6

See more details on using hashes here.

Release history Release notifications | RSS feed

10.18.0

2 files

10.17.0

2 files

10.16.0

2 files

10.15.2

2 files

10.11.2

2 files

10.11.1

2 files

10.11.0

2 files

10.10.0

2 files

10.9.3

2 files

10.9.2

2 files

10.9.1

2 files

10.9.0

2 files

This release

10.8.0 This release

2 files

10.7.1

2 files

10.7.0

2 files

10.6.0

2 files

10.5.0

2 files

10.4.0

2 files

10.3.0

2 files

10.2.0

2 files

10.1.1

2 files

10.1.0

2 files

10.0.0

2 files

9.0.0

2 files

8.0.1

2 files

8.0.0

2 files

7.2.0

2 files

7.1.2

2 files

7.1.1

2 files

7.1.0

2 files

7.0.1

2 files

7.0.0

2 files

6.3.0

2 files

6.2.1

2 files

6.2.0

2 files

6.1.0

2 files

6.0.0

2 files

5.3.22

2 files

5.3.21

2 files

5.3.20

2 files

5.3.19

2 files

5.3.18

2 files

5.3.17

2 files

5.3.16

2 files

5.3.15

2 files

5.3.14

2 files

5.3.13

2 files

5.3.12

2 files

5.3.11

2 files

5.3.10

2 files

5.3.9

2 files

5.3.8

2 files

5.3.7

2 files

5.3.6

2 files

5.3.4

2 files

5.3.3

2 files

5.3.2

2 files

5.3.1

2 files

5.3.0

2 files

5.1.1

2 files

5.0.17

2 files

5.0.14

2 files

5.0.13

2 files

5.0.12

2 files

5.0.11

2 files

5.0.8

2 files

5.0.0

2 files

4.5.3

2 files

4.5.1

2 files

4.1.4

2 files

4.1.3

2 files

4.1.2

2 files

4.1.1

2 files

4.1.0

2 files

4.0.16

2 files

4.0.15

2 files

4.0.14

2 files

4.0.13

2 files

4.0.12

2 files

4.0.11

2 files

4.0.9

2 files

4.0.8

2 files

4.0.6

2 files

4.0.5

2 files

4.0.3

2 files

4.0.2

2 files

4.0.1

2 files

4.0.0

2 files

3.15.1

2 files

3.15.0

2 files

3.14.9

2 files

3.14.8

2 files

3.14.7

2 files

3.14.6

2 files

3.14.5

2 files

3.14.4

2 files

3.14.3

2 files

3.14.2

2 files

3.14.1

2 files

3.14.0

2 files

3.13.9

2 files

3.13.8

2 files

3.13.7

2 files

3.13.6

2 files

3.13.5

2 files

3.13.3

2 files

3.13.2

2 files

3.13.1

2 files

3.12.9

2 files

3.12.8

2 files

3.12.7

2 files

3.12.6

2 files

3.12.5

2 files

3.12.4

2 files

3.12.3

2 files

3.12.2

2 files

3.12.1

2 files

3.12.0

2 files

3.11.8

2 files

3.11.7

2 files

3.11.6

2 files

3.11.5

2 files

3.11.4

2 files

3.11.3

2 files

3.11.2

2 files

3.11.1

2 files

3.11.0

2 files

3.10.10

2 files

3.10.9

2 files

3.10.8

2 files

3.10.7

2 files

3.10.6

2 files

3.10.5

2 files

3.10.4

2 files

3.10.3

2 files

3.10.2

2 files

3.10.1

2 files

3.10.0

2 files

3.9.9

2 files

3.9.8

2 files

3.9.7

2 files

3.9.6

2 files

3.9.5

2 files

3.9.4

2 files

3.9.3

2 files

3.9.2

2 files

3.9.0

2 files

3.8.0

2 files

3.7.2

2 files

3.7.1

2 files

3.7.0

2 files

3.5.9

2 files

3.5.8

2 files

3.5.7

2 files

3.5.6

2 files

3.5.5

2 files

3.5.4

2 files

3.5.3

2 files

3.5.1

2 files

3.5.0

2 files

3.4.9

2 files

3.4.8

2 files

3.4.7

2 files

3.4.6

2 files

3.4.5

2 files

3.4.3

2 files

3.4.2

2 files

3.4.1

2 files

3.4.0

2 files

3.1.0

2 files

3.0.5

2 files

3.0.4

2 files

3.0.3

2 files

3.0.1

2 files

3.0.0

2 files

2.4.0

2 files

2.3.1

2 files

2.3.0

2 files

2.2.5

2 files

2.2.4

2 files

2.2.3

2 files

2.2.1

2 files

2.2.0

2 files

2.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page