Skip to main content

Getting Started

Install Encord Active

Install encord-active in your favorite Python environment with the following commands:

python -m venv ea-venv
pip install encord-active

encord-active requires python 3.9 or above and git VCS. If you encounter any difficulties during the installation of encord-active, you can refer to our detailed instructions available here.


You can also run the docker image instead of install Encord Active

docker run -it -p 8000:8000 -v ${PWD}:/data encord/encord-active <command>

Encord Active Quickstart

Understand Encord Active in 5 minutes by playing!

The script will download a small example project to your current working directory and open the application straight away. This is the fastest way to explore Encord Active.

# within venv
encord-active quickstart

This must be run in the same virtual environment where you installed your package.

The next section will show you how to download larger and more interesting datasets to explore.

Sandbox Dataset

If you have more time, we have pre-built a few sandbox datasets with data, labels, and model predictions for you to start exploring Encord Active.

To get started quickly with a sandbox dataset, you can run the following command:

# within venv
encord-active download

This will allow you to choose a dataset to download. When the download process is complete, you visualize the results by following the printed instructions.


You can follow the COCO sandbox dataset tutorial to learn the features of Encord Active.

Run Encord Active on Google Colab

If you want to quickly explore Encord Active without installing anything into your local machine, we have the following Google Colab notebooks for you:

  1. Explore Encord Active sandbox dataset
  2. Explore Encord Active through your own Encord projects

Import Your Own Data

To import your own data save your data in a directory and run the command:

# within venv
encord-active init /path/to/data/directory

A project will be created using the data (without labels) in the current working directory (unless used with --target).

To start the project run:

cd /path/to/project
encord-active start

You can find more details on the init command in the CLI section.

Import an Encord Project

If you are an Encord user, you can directly import your own projects into Encord Active easily.

# within venv
encord-active import project

This will import your encord project to a new directory in your current working directory. If you don't have an Encord project ready, you can either

  1. Initialise a project from a local data directory
  2. Import a project from COCO
  3. Download one of our sandbox datasets

If you are new to the Encord platform, you can easily create an Encord account by signing up.

To be able to import an Encord project, you will need the path to your private SSH key associated with Encord (see documentation here).

The command will ask you:

  1. Where is your private ssh key stored?: type the path to your private ssh key
  2. What project would you like to import?: here, you can (fuzzy) search for the project title that you would like to import. Hit enter when your desired project is highlighted.

Next, encord-active will fetch your data and labels before computing all the metrics available in encord-active.

Downloading the data and computing the metrics may take a while. Bare with us, it is worth the wait.

When the process is done, follow the printed instructions to open the app or see more details in the Open Encord Active page.

Running the App

To launch the Encord Active app, run the following command:

# within venv
cd /path/to/project
encord-active start

Now, your browser should open a new window with Encord Active.


If the script just seems to hang and nothing happens in your browser, try visiting http://localhost:8501.

What's Up Next?

We recommend to take a look at any of the tutorials that demonstrate Encord Active's capabilities and the workflows section to learn about improving your model performance. A couple of example references are:

  1. Import your model predictions
  2. Find outliers in your data or your labels
  3. Identify metrics that are important for your model performance

You can also have a look at how to write custom metrics and how to use the command line interface.

Need Support?

Please don't hesitate to contact us if you have any questions via our dedicated Discord server or email at

If you encounter any errors, we would love to hear from you so we can address them promptly. We receive immediate notifications when issues are submitted through Encord Active's GitHub repository. Also, feel free to reach out to us via Discord or email at for further assistance. We appreciate your feedback and assistance in improving Encord Active.