Installation Overview

Naomi is based on the Jasper framework and is fully written in Python. As such, it only depends on a python installation, which is available for many platforms. Naomi can be executed on different versions of macOS and Windows and many different variants of Linux (Ubuntu, Raspberry Pi OS, ...).

If you are coming from Jasper please be aware of the fact that Naomi is programmed on a new base and introduces new concepts. Therefore, tutorials and help you may find on the internet for Jasper WILL be outdated!

Platform Recommendations

Many devices are suited to host a continuous installation of Naomi.

The Raspberry Pi is our system recommendation as well as quite popular, especially as we offer a quick setup with Naobian. At Project Naomi we recommend installing Naomi on the Raspberry Pi however other platform options are available.

Please check the menu to the left for all available installation options.


Due to the way we have structured the setup of Naomi, there are no software prerequisites (Naomi handles all of that for you!). All you need to run Naomi is compatible hardware & OS.

Setup variants

Before you can start, two decisions have to be made:

  1. Naomi is available as a platform independent archive file or through a package:

    • Manual setup: Download and extract a platform independent zip archive: RPI, macOS, Windows, Linux.
    • Packaged setup: Install though a package repository, built images, or an All-in-One Application: Naobian, Virtual Box, & Docker.
  2. Stable release, Monthly release, or cutting edge:

    • Stable: (Current: 2.2) are thoroughly tested semi-annual official releases of Naomi. Use the stable version for your production environment if you don't need the latest enhancements and prefer a robust system.
    • Milestone: (Current: 3.0.M16) are intermediary releases of the next Naomi version, released about once a month, and they include the new recently added features and bug fixes. They are a good compromise between the current stable version and the bleeding-edge and potentially unstable nightly version. Milestones releases are Highly Recommended for most users.
    • Nightly: At most 1 or 2 days old and include the latest code. Use nightly for testing out very recent changes, but be aware some nightly versions might be unstable. Use in production at your own risk!


Please follow the instructions in the installation page matching your platform (see the menu to the left).


If you run into any problems, use the search function or open a new thread with your detailed question on the Naomi Community Forum.