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.5.0.tar.gz (1.8 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.5.0-py3-none-any.whl (1.9 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: klotho_cac-10.5.0.tar.gz
  • Upload date:
  • Size: 1.8 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.5.0.tar.gz
Algorithm Hash digest
SHA256 57bf3789341ecf516e3321dce6da489549069ce15c0d2dce1cd44f8025acb594
MD5 f866ec82f4d8765cfd82a3012c78a3d8
BLAKE2b-256 afe255f25151857679291e886552474e691dce400a0c1a7b9fa8b71540f8b4eb

See more details on using hashes here.

File details

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

File metadata

  • Download URL: klotho_cac-10.5.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.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c385d3f945c652c30f8008cdd01e131fc3bae55bf9d192902b9cf9487248c155
MD5 a1af7a573f9e5f8ce0c17417c160c20c
BLAKE2b-256 ad5058f4bb7b3b076ea135075187b1c19221f3755007566949c897b6bb24bf8b

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

10.8.0

2 files

10.7.1

2 files

10.7.0

2 files

10.6.0

2 files

This release

10.5.0 This release

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