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

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.15.2.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.15.2-py3-none-any.whl (2.0 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: klotho_cac-10.15.2.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.15.2.tar.gz
Algorithm Hash digest
SHA256 981ef499bed5711288f761c718dde3b8210ef5f5fa4fffb970cdce0b468f259e
MD5 ce63406ac4afdd1882ed4c1b4beedac5
BLAKE2b-256 a527be1b6fdeee59f5249357c0e256af4950d29481994faae0cb06e04f475fe2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: klotho_cac-10.15.2-py3-none-any.whl
  • Upload date:
  • Size: 2.0 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.15.2-py3-none-any.whl
Algorithm Hash digest
SHA256 919d82c7f7172e192baa831b1f2bd937ce5c1304cf06765cc3e3840558248228
MD5 03dcb68dd55c6a12bd982ff54918734b
BLAKE2b-256 0715b6685bc53a9efc1307119c0c8ba81fa511280a25ae8134e8c533cc6765db

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

This release

10.15.2 This release

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

10.8.0

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