Set up your Workspace

Connect to the Evidently Cloud or a self-hosted Workspace.

What is a Workspace?

You need a workspace to organize your data and Projects.

  • In Evidently Cloud, your account is your Workspace. As simple as that!

  • In self-hosted deployments, a Workspace is a remote or local directory where you store the snapshots. The Monitoring UI will read the data from this source.

Evidently Cloud

If you do not have one yet, create an Evidently Cloud account.

Get the API token. You will use it to connect with Evidently Cloud Workspace from your Python environment. Use the "key" sign in the left menu to get to the token page, and click "generate token." Save it in a temporary file since it won't be visible once you leave the page.

Connect to the Workspace. To connect to the Evidently Cloud Workspace, you must first install Evidently.

pip install evidently

Then, run imports and pass your API token to connect:

from import CloudWorkspace

ws = CloudWorkspace(

What's next? Head to the next section to see how to add your first Project.


Local Workspace

In this scenario, you will generate, store the snapshots and run the monitoring UI on the same machine.

To create a local Workspace and assign a name:

ws = Workspace.create("evidently_ui_workspace")

You can pass a path parameter to specify the path to a local directory.

Code example Self-hosting tutorial shows a complete Python script to create and populate a local Workspace.

Remote Workspace

In this scenario, you send the snapshots to a remote server. You must run the Monitoring UI on the same remote server. It will directly interface with the filesystem where the snapshots are stored.

To create a remote Workspace (UI should be running at this address):

workspace = RemoteWorkspace("http://localhost:8000")

You can pass the following parameters:

Code example. See the remote service example.

Remote snapshot storage

In the examples above, you store the snapshots and run the UI on the same server. Alternatively, you can store snapshots in a remote data store (such as an S3 bucket). The Monitoring UI service will interface with the designated data store to read the snapshot data.

To connect to data stores Evidently uses fsspec that allows accessing data on remote file systems via a standard Python interface.

You can verify supported data stores in the Fsspec documentation: built-in implementations and other implementations.

For example, to read snapshots from an S3 bucket (with MinIO running on localhost:9000), you must specify environment variables:

FSSPEC_S3_KEY=my_key FSSPEC_S3_SECRET=my_secret
evidently ui --workspace s3://my_bucket/workspace

Launch the UI service

To launch the Evidently UI service, you must run a command in the Terminal.

Option 1. If you log snapshots to a local Workspace directory, you run Evidently UI over it. Run the following command from the directory where the Workspace folder is located.

evidently ui

Option 2. If you have your Project in a different Workspace, specify the path:

evidently ui --workspace . /workspace

Option 3. If you have your Project in a specified Workspace and run the UI service at the specific port (if the default port 8000 is occupied).

evidently ui --workspace ./workspace --port 8080

To view the Evidently interface, go to URL http://localhost:8000 or a specified port in your web browser.

[DANGER] Delete Workspace

To delete a Workspace (for example, an empty or a test Workspace), run the command from the Terminal:

cd src/evidently/ui/
rm -r workspace

You are deleting all the data. This command will delete the snapshots stored in the folder. To maintain access to the generated snapshots, you must store them elsewhere.

What’s next?

After you set up a Workspace, you can add and manage Projects. Head to the next section to see how.

Last updated