Skip to content

Installing MPF

The current stable version of MPF is 0.56.x.

MPF should work with following platforms:

  • Windows 10 / Windows 11 (64-bit only)
  • macOS 10.14+, up through macOS 13 Ventura (Intel & Apple Silicon)
  • Linux (64-bit, lots of distros)
  • Raspberry Pi

MPF 0.56 only works with Python 3.7 - 3.9.

MPF 0.57 supports Python 3.10 & 3.11

MPF 0.57, which is the current dev branch of MPF, supports Python 3.8 - 3.11. See our 0.57 page for details.

Here links to the installation guides for each platform:

Next step: The Tutorial!

We have a tutorial which walks you through the first few steps of getting your project started at

Something missing or wrong? You can fix it!

This website is edited by people like you! Is something wrong or missing? Is something out of date, or can you explain it better?

Please help us! You can fix it yourself and be an official "open source" contributor!

It's easy! See our Beginner's guide to editing the docs.

Page navigation via the keyboard: < >

You can navigate this site via the keyboard. There are two modes:

General navigation, when search is not focused:

  • F , S , / : open search dialog
  • P , , : go to previous page
  • N , . : go to next page

While using the search function:

  • Down , Up : select next / previous result
  • Esc , Tab : close search
  • Enter : go to highlighted page in the results