PerceptiLabs is distributed as a free Python package (hosted on PyPI) for everyone to use.

This topic describes how to install and run the free version of Perceptilabs.

Step 1: Install and Run PerceptiLabs

Follow the steps below to install and run the free version of PerceptiLabs:

Free Version

1. Install a version of Python that meets our Python Requirements. Since multiple versions of Python and PerceptiLabs can be installed concurrently, we recommend you install them in a virtual Python environment such as:

The steps below show how to set up a simple Conda environment:

  1. Download Anaconda and install it

  2. Open a terminal window.

  3. Run: conda create -n myenv python=3.8

  4. Run: conda activate myenv

2. Run the following command to install PerceptiLabs:

pip install perceptilabs


Alternatively, you can install our latest nightly build with pip install pl-nightly. Note that the nightly build may not be as stable as the latest official release.

3. Run perceptilabs. The app will open in your default web browser.


If you're using Chrome, first ensure that hardware acceleration is enabled to ensure the best performance of PerceptiLabs on this browser.

To enable this, click on Chrome's triple-dot menu and select Settings. Then navigate to Advanced > System and enable Use hardware acceleration when available; you may need to relaunch your browser as well.

Step 2: Sign in

Free Version

Within PerceptiLabs, sign up for a free PerceptiLabs account and then sign in to start building your machine learning models with PerceptiLabs!

Step 3: Load and Pre-process Your Data

Now that you've installed and signed into Perceptilabs, proceed to Load and Pre-process Data to learn how to get started building a model.

Last updated