Manage Projects
Set up a Project for your evaluation or monitoring use case.
Before creating a Project, you need a Workspace.
In Evidently Cloud, your account is your Workspace. Set up an account and connect from Python.
In self-hosted deployments, a Workspace is a remote or local directory. Create and connect to a workspace.
Create a Project
You can create a Project using the Python API or directly in the user interface.
Add a new Project - API
To create a Project inside a workspace ws
and Organization (see organizations) with an org_id
, assign a name and description, and save the changes:
In self-hosted open-source installation, you do not need to pass the Team ID. To create a Project:
Add a new Project - UI
Click on the โplusโ sign on the home page, type your Project name and description.
After creating a Project, you can click to open a Dashboard. Since there's no data yet, it will be empty.
Project ID. Once you run create_project
, you will see the Project ID. You can later use it to reference the Project. You can also copy the Project ID directly from the UI: it appears above the monitoring Dashboard.
Manage Project
Connect to a Project
To connect to an existing Project from Python, use the get_project
method.
Save changes
After making changes to the Project (such as editing description or adding monitoring Panels), always use the save()
command:
Browse Projects
You can see all available Projects on the monitoring homepage, or request a list programmatically. To get a list of all Projects in a workspace ws
, use:
To find a specific Project by its name, use the search_project
method:
[DANGER] Delete Project
You are deleting the data in a Project. If you delete a Project, you will delete all the snapshots stored inside it.
To delete the Project and all the data inside it:
Project parameters
Each Project has the following parameters.
name: str
Project name.
id: UUID4 = Field(default_factory=uuid.uuid4)
Unique identifier of the Project. Assigned automatically.
description: Optional[str] = None
Optional description. Visible when you browse Projects.
dashboard: DashboardConfig
date_from: Optional[datetime.datetime] = None
Start DateTime of the monitoring Dashboard. By default, Evidently shows data for all available periods based on the snapshot timestamps.
You can set a different DateTime. E.g., to refer to the last 30 days:
from datetime import datetime, timedelta
datetime.now() + timedelta(-30)
date_to: Optional[datetime.datetime] = None
End DateTime of the monitoring Dashboard. Works the same as above.
Whatโs next?
Once you create or connect to a Project, you can:
Send snapshots using the
add_report
oradd_test_suite
methods.Configure the monitoring Dashboard in the user interface or via the Python API.
Last updated