Install and initialize the ValidMind Library

Initialize the ValidMind Library with the code snippet unique to each model per document to connect your environment to the ValidMind Platform, ensuring test results are uploaded to the correct model and automatically populated in the right document.

Prerequisites

• You are logged in to ValidMind.
• The model you want to connect to is registered in the model inventory.¹
• The model document has a template applied.²
• You are the model owner, model validator, or another model stakeholder with write access to the model's documents.³

¹ Register models in the inventory

² Working with templates

³ Manage model stakeholders

The ValidMind Library requires access to the data sources where relevant datasets and model files are stored in order to help you run tests.

Installing the ValidMind Library

In order to upload test results from the ValidMind Library to the ValidMind Platform, provide the following information through a code snippet copied from the platform:

Argument	Description
api_host	The location of the ​ValidMind API
api_key	The account API key
api_secret	The account secret key
document	The model document identifier key
model	The model identifier

Get your code snippet

Retrieve your code snippet for your model's selected document from the ValidMind Platform:

1. In the left sidebar, click Inventory.

2. Select a model by clicking on it or find your model by applying a filter or searching for it.⁴

3. In the left sidebar that appears for your model, click Getting Started.

4. Select the document you want to automatically upload test results to.⁵

5. Click Copy snippet to clipboard.

⁴ Working with the model inventory

⁵ Working with model documents

NoneSelecting a document to connect to requires ValidMind Library version >=2.12.0.⁶

A template must already be applied to your selected document to populate test results in the ValidMind Platform. Attempting to initialize the library with a document that does not have a template applied will result in an error.

⁶ Upgrade the ValidMind Library

Install the library

To install the library:

%pip install validmind

Initialize the library

To initialize the library, paste the code snippet with the client integration details directly into your development source code, replacing this example with your own:

import validmind as vm

vm.init(
  api_host = "https://API_HOST.validmind.ai/api/v1/tracking",
  api_key = "API_KEY",
  api_secret = "API_SECRET",
  document="document-key", # requires library >=2.12.0
  model = "MODEL_IDENTIFIER"
)

To also enable monitoring, add monitoring=True to the vm.init method in your code snippet. ⁷

⁷ Ongoing monitoring

Automate with ​ValidMind

After you run the code snippet in your environment, the ValidMind Library will connect to your model and selected document in the ValidMind Platform. Automate your workflow by using the library to run tests, then seamlessly upload your test results to the platform.

Upgrade the ValidMind Library

After installing the ValidMind Library,⁸ you'll want to periodically make sure you are on the latest version to access any new features and other enhancements:

⁸ Install ​ValidMind

1. In your Jupyter Notebook or developer environment, retrieve the information for the currently installed version of the library:

   %pip show validmind

Example output:

Name: validmind
Version: 2.11.0
...

2. If the version returned is lower than the version indicated in our production open-source code,⁹ run the following command:

   %pip install --upgrade validmind

⁹ ValidMind GitHub: validmind-library/validmind/__version__.py

What's next