<img align="right" src="https://raw.githubusercontent.com/artisan-roaster-scope/artisan/master/wiki/screenshots/artisan.png" width="70">

Artisan

Visual scope for coffee roasters

WARNING: pre-release (continuous) builds may not work. Use at your own risk.

Summary

Artisan is a software that helps coffee roasters record, analyze, and control roast profiles. When used in conjunction with a thermocouple data logger or a proportional–integral–derivative controller (PID controller), this software can automate the creation of roasting metrics to help make decisions that influence the final coffee flavor.

Artisan is listed on Awesome Python Applications.

Donations

This software is open-source and absolutely free to use, also in commercial settings.

If you think Artisan is useful to you, contribute financially to its further development. Send any amount via my PayPal.Me page. Thanks!

Home roasting enthusiasts often donate 10-100.- (in $ or EUR), while small roasting businesses and consultant that use Artisan in their daily work tend to donate 100-300.- (in $ or EUR). For extra tech support, please inquire.

Download (macOS/Windows/Linux/RPi)

Installation Instructions

Documentation

PLEASE FOLLOW AND TAG US!     <a href="https://www.facebook.com/ArtisanScope"><img src="https://github.com/artisan-roaster-scope/artisan/blob/master/wiki/screenshots/facebook-square.svg?raw=true" width="30"></a>   <a href="https://www.instagram.com/artisanscope/"><img src="https://github.com/artisan-roaster-scope/artisan/blob/master/wiki/screenshots/instagram-square.svg?raw=true" width="30"></a>   <a href="https://www.youtube.com/channel/UCEp-DH_Y7sBR3-X3FWomgog"><img src="https://github.com/artisan-roaster-scope/artisan/blob/master/wiki/screenshots/youtube-svgrepo-com.svg?raw=true" width="30"></a>   <a href="https://masto.ai/@artisan"><img src="https://github.com/artisan-roaster-scope/artisan/blob/master/wiki/screenshots/mastodon-icon-svgrepo-com.svg?raw=true" width="30"></a>   <a href="https://www.linkedin.com/company/artisan-plus"><img src="https://github.com/artisan-roaster-scope/artisan/blob/master/wiki/screenshots/linkedin-svgrepo-com.svg?raw=true" width="30"></a>

<a id="version_history"></a> Version History

Detailed Release History

| Version | Date | Comment | |---------|------:|---------| | v4.0.2 | Feb 7, 2026 | Bug fixes | | v4.0.0 | Jan 28, 2026 | Adds UI modes, adds support for Lebrew RoastSee NEXT and Acaia Pyxis Black (2025), 2DOF software PID implementation with interpolated gain scheduling, bumpless transfer and filtering, general stability and performance improvements.<br>:heart: <b>Release Sponsor: artisan.plus</b> :heart: | | v3.4.0 | Oct 31, 2025 | Adds support for Kraffe, Berto, Nordic PLC, Prisma, additional Easyster and Proaster models, the latest Cogen and Toper roasters, and updates setups for Sweet Coffee Italia and Joper machines. Adds support for Tasi TA612C 4-channel and Shelly energy meters, as well as the ability to import Cropster profiles through drag-and-drop. Enables multi-day coffee fermentation experiments. Adds Czech and improved Chinese, Korean, and Spanish localizations. Updates the internal PID algorithm with advanced algorithmic and the app icon for the glass era (last version featuring legacy builds supporting macOS 10.13+ and Window 8).<br>:heart: <b>Release Sponsor: artisan.plus</b> :heart: | | v3.2.0 | Jun 23, 2025 | Adds batch manager and support for the Acaia relay scales UMBRA and COSMO (last version supporting macOS 12, Ubuntu 22.04 and RedHat 8.4).<br>:heart: <b>Release Sponsor: Acaia</b> :heart: | | v3.1.4 | May 1, 2025 | Fixes backward compatibility with some existing MODBUS configurations broken by v3.1.2 | | v3.1.2 | Apr 30, 2025 | Adds roast defects weight, event replay ramping, event dragging, Aillio Bullet R2 support, IMF machine control setups, extended support for Giesen machines, fixes Loring autoCHARGE/DROP, adds Carmomaq's Stratto Lab sample roaster, Phidget motor controllers, support for energy meters, ROEST CSV import, improved Cropster import, many small fixes and UI improvements | | v3.1.0 | Nov 22, 2024 | Adds support for induction heated Gemma machines by Sweet Coffee Italia, the latest Santoker machines connecting via Bluetooth, Primo roasting machines, ColorTrack sensors, Stronghold profile import, and Phidget stepper controllers and more.<br>:heart: <b>Release Sponsor: Algrano</b> :heart: | | v3.0.2 | Aug 20, 2024 | Bug fixes | | v3.0.0 | Aug 1, 2024 | Adds roast scheduling support<br>:heart: <b>Release Sponsor: artisan.plus</b> :heart: | | v2.10.4 | Mar 21, 2024 | Bug fixes | | v2.10.2 | Feb 29, 2024 | Adds support for machines from Mill City Roasters, the IKAWA PRO X, the standard WinUSB driver for the Aillio R1 on Windows, the Digi-Sense 20250-07 IR, and the [Extech 42570 IR](https://www.extech-online.com/index.php?main_page=prod