LogoLogo
HomeBlogGitHub
latest
latest
  • New DOCS
  • What is Evidently?
  • Get Started
    • Evidently Cloud
      • Quickstart - LLM tracing
      • Quickstart - LLM evaluations
      • Quickstart - Data and ML checks
      • Quickstart - No-code evaluations
    • Evidently OSS
      • OSS Quickstart - LLM evals
      • OSS Quickstart - Data and ML monitoring
  • Presets
    • All Presets
    • Data Drift
    • Data Quality
    • Target Drift
    • Regression Performance
    • Classification Performance
    • NoTargetPerformance
    • Text Evals
    • Recommender System
  • Tutorials and Examples
    • All Tutorials
    • Tutorial - Tracing
    • Tutorial - Reports and Tests
    • Tutorial - Data & ML Monitoring
    • Tutorial - LLM Evaluation
    • Self-host ML Monitoring
    • LLM as a judge
    • LLM Regression Testing
  • Setup
    • Installation
    • Evidently Cloud
    • Self-hosting
  • User Guide
    • 📂Projects
      • Projects overview
      • Manage Projects
    • 📶Tracing
      • Tracing overview
      • Set up tracing
    • 🔢Input data
      • Input data overview
      • Column mapping
      • Data for Classification
      • Data for Recommendations
      • Load data to pandas
    • 🚦Tests and Reports
      • Reports and Tests Overview
      • Get a Report
      • Run a Test Suite
      • Evaluate Text Data
      • Output formats
      • Generate multiple Tests or Metrics
      • Run Evidently on Spark
    • 📊Evaluations
      • Evaluations overview
      • Generate snapshots
      • Run no code evals
    • 🔎Monitoring
      • Monitoring overview
      • Batch monitoring
      • Collector service
      • Scheduled evaluations
      • Send alerts
    • 📈Dashboard
      • Dashboard overview
      • Pre-built Tabs
      • Panel types
      • Adding Panels
    • 📚Datasets
      • Datasets overview
      • Work with Datasets
    • 🛠️Customization
      • Data drift parameters
      • Embeddings drift parameters
      • Feature importance in data drift
      • Text evals with LLM-as-judge
      • Text evals with HuggingFace
      • Add a custom text descriptor
      • Add a custom drift method
      • Add a custom Metric or Test
      • Customize JSON output
      • Show raw data in Reports
      • Add text comments to Reports
      • Change color schema
    • How-to guides
  • Reference
    • All tests
    • All metrics
      • Ranking metrics
    • Data drift algorithm
    • API Reference
      • evidently.calculations
        • evidently.calculations.stattests
      • evidently.metrics
        • evidently.metrics.classification_performance
        • evidently.metrics.data_drift
        • evidently.metrics.data_integrity
        • evidently.metrics.data_quality
        • evidently.metrics.regression_performance
      • evidently.metric_preset
      • evidently.options
      • evidently.pipeline
      • evidently.renderers
      • evidently.report
      • evidently.suite
      • evidently.test_preset
      • evidently.test_suite
      • evidently.tests
      • evidently.utils
  • Integrations
    • Integrations
      • Evidently integrations
      • Notebook environments
      • Evidently and Airflow
      • Evidently and MLflow
      • Evidently and DVCLive
      • Evidently and Metaflow
  • SUPPORT
    • Migration
    • Contact
    • F.A.Q.
    • Telemetry
    • Changelog
  • GitHub Page
  • Website
Powered by GitBook
On this page
  • Create a Project
  • Add a new Project - API
  • Add a new Project - UI
  • Manage Project
  • Connect to a Project
  • Save changes
  • Browse Projects
  • [DANGER] Delete Project
  • Project parameters
  • What’s next?
  1. User Guide
  2. Projects

Manage Projects

Set up a Project for your evaluation or monitoring use case.

PreviousProjects overviewNextTracing

Last updated 2 months ago

You are looking at the old Evidently documentation: this API is available with versions 0.6.7 or lower. Check the newer version .

Before creating a Project, you need a Workspace.

  • In Evidently Cloud, your account is your Workspace. .

  • In self-hosted deployments, a Workspace is a remote or local directory. .

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 () with an org_id, assign a name and description, and save the changes:

project = ws.create_project("My test project", org_id="YOUR_ORG_ID")
project.description = "My project description"
project.save()

In self-hosted open-source installation, you do not need to pass the Team ID. To create a Project:

project = ws.create_project("My test project")
project.description = "My project description"
project.save()

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.

project = ws.get_project("PROJECT_ID")

Save changes

After making changes to the Project (such as editing description or adding monitoring Panels), always use the save() command:

project.save()

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:

ws.list_projects()

To find a specific Project by its name, use the search_project method:

ws.search_project("project_name")

[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:

# ws.delete_project("PROJECT ID")

Go to the "home page", and hover over a Project name. Click on the bin sign and confirm that you want to delete the Project.

Project parameters

Each Project has the following parameters.

Parameter
Description

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:

Dashboard configuration that describes the composition of the monitoring Panels. Note: See for details. You don't need to explicitly pass DashboardConfig if you use the .dashboard.add_panel method to add Panels.

using the add_report or add_test_suite methods.

Configure the monitoring Dashboard in the or via the .

📂
here
Set up an account and connect from Python
Create and connect to a workspace
see organizations
Send snapshots
user interface
Python API
Dashboard Design