Machine learning audio classification engine for Artisan
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
scripts Kill processes from prior runs if they're still hanging around Sep 9, 2016
.gitattributes 👾 Added .gitattributes & .gitignore files Sep 8, 2016
.gitignore 👾 Added .gitattributes & .gitignore files Sep 8, 2016
install.cmd Initial commit Sep 8, 2016 Documentation Sep 8, 2016


Machine learning audio classification engine for Artisan

RoastLearner allows your computer to "hear" the sounds of first crack while roasting with the Artisan Roaster Scope software. RoastLearner uses a microphone to record the sound of your roast, provides a platform to train the sounds made during that process, and then runs the trained classifiers during future roasts to classify what it's "hearing" while sending the results to Artisan in (near) real time.

RoastLearner is a collection of scripts to record audio samples during the coffee roasting process and to classify the recorded sounds into user-defined classes like "firstcrack" or "environment". This data can be presented to the Artisan Roaster Scope software to be graphed or to help control the roast in response to audible events.

RoastLearner also includes tools to train classification engines against data recorded from previous roasts.

RoastLearner acts as a wrapper for the excellent PyAudioAnalysis audio classification toolkit. The RoastLearner distribution also includes compiled binaries for SoX to record audio from your default microphone.

Here's a video demonstrating the classifiers in action during a roast being controlled by Artisan.

RoastLearner video


  • RoastLearner currently supports Windows installations only.
  • Artisan 1.0 or above
  • Python 2.7 for Windows and a pile of additional modules. Read here for detailed installation instructions on setting up the Python environment.
  • A microphone positioned somewhere where it can pick up the sounds from your roaster. This was developed with a cheap $9 USB microphone so nothing fancy is required here. The microphone must be set as the default recording device in Windows.

Getting Started

  1. Install Artisan to the default location.
  2. Install Python27, our required modules, and the PyAudioAnalysis libraries.
  3. Install RoastLearner.
  4. Configure Artisan to run RoastLearner.
  5. Run one or more roasts to collect some initial recordings of the sounds your machine makes during the roast process.
  6. Manually classify your recordings and train the RoastLearner classifier(s).