Skip to main content

Computer-Aided Rhythm Analysis Toolbox

Project description


 _  _  __ _ _|_
(_ (_| | (_| |_   computer-aided rhythm analysis toolbox

PyPI License


See for a complete reference manual and introductory tutorials.

Demonstration notebooks

Some demonstrations of what you can do with carat:


The latest stable release is available on PyPI, and you can install it by

pip install carat

To build carat from source, use python build. Then, to install carat, say python install. If all went well, you should be able to execute the demo scripts under examples/ (OS X users should follow the installation guide given below).

Alternatively, you can download or clone the repository and use pip to handle dependencies:

pip install -e carat


git clone
pip install -e carat

By calling pip list you should see carat now as an installed pacakge:

carat (0.x.x, /path/to/carat)

Hints for the Installation

carat uses librosa to load audio files. The following are the installation hints provided by librosa in order to install the needed dependencies to load audio files.

librosa uses soundfile and audioread to load audio files. Note that soundfile does not currently support MP3, which will cause librosa to fall back on the audioread library.


If you're using pip on a Linux environment, you may need to install libsndfile manually. Please refer to the SoundFile installation documentation for details.

audioread and MP3 support

To fuel audioread with more audio-decoding power (e.g., for reading MP3 files), you may need to install either ffmpeg or GStreamer.

Note that on some platforms, audioread needs at least one of the programs to work properly.

Here are some common commands for different operating systems:

  • Linux (apt-get): apt-get install ffmpeg or apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
  • Linux (yum): yum install ffmpeg or yum install gstreamer1.0-plugins-base gstreamer1.0-plugins-ugly
  • Mac: brew install ffmpeg or brew install gstreamer
  • Windows: download binaries from the website

For GStreamer, you also need to install the Python bindings with

pip install pygobject


If you want to cite carat please cite the paper published at AAWM 2019:

Rocamora, and Jure. "carat: Computer-Aided Rhythmic Analysis Toolbox." In Proceedings of Analytical Approaches to World Music. 2019.

Project details

Download files

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

Files for carat, version 0.1.1
Filename, size & hash File type Python version Upload date
carat-0.1.1-py3-none-any.whl (22.8 kB) View hashes Wheel py3
carat-0.1.1.tar.gz (18.6 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page