klotho-cac 4.0.6

Graph-Oriented Computer-Assisted Composition in Python

Klotho

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, models, works, and frameworks associated with music composition and metacomposition.

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

---

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.

---

Tutorials

Interactive Tutorials: https://kr4g.github.io/Klotho/

Browse the Klotho tutorial series directly in your browser — no installation required.

---

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

---

About

Klotho extends from a lineage of computer-assisted composition (CAC) theories, practices, and software environments. While it provides support for conventional musical materials, its strengths are best utilized when working with complex, abstract, or otherwise unconventional musical structures not easily accessible with traditional notation software or digital audio workstations.

Contributing

Contributions of all kinds are welcome — whether it's code, bug reports, documentation improvements, or ideas for new features. To contribute, fork the repository, create a branch, and open a pull request. For bugs or suggestions, open an issue on GitHub Issues. All contributions are accepted under the same CC BY-SA 4.0 license, and contributors are credited through Git history.

License

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