Troubleshooting

Published

May 12, 2025

Learn how to resolve commonly encountered issues with the ValidMind AI risk platform.

Cannot access expected features

Issue

You cannot access functionality described in our user guides or recent releases.

Fix

Make sure you are running most recent versions of ​ValidMind,1 and have the proper permissions assigned.2

Cannot install the ValidMind Library

Issue

You cannot run pip install validmind or import validmind as vm in the ValidMind Library notebooks.

Fix

Make sure you are installing the latest version of the library3 by running this command:

%pip install --upgrade validmind

Cannot initialize the ValidMind Library

Issue

When you run vm.init(), you encounter an error message like this:

MissingAPICredentialsError: API key and secret must be provided either as environment variables or as arguments to init.

or

InvalidProjectError: Model could not be found

Fix

Make sure that you are using the correct initialization credentials for the model you are trying to connect to.

Follow the steps in Install and initialize the ValidMind Library for detailed instructions on how to integrate the library and upload to the platform.

::: {.attn}

How to upgrade

ValidMind Platform

To access the latest version of the ValidMind Platform,4 hard refresh your browser tab:

  • Windows: Ctrl + Shift + R OR Ctrl + F5
  • MacOS: ⌘ Cmd + Shift + R OR hold down ⌘ Cmd and click the Reload button

ValidMind Library

To upgrade the ValidMind Library:5

  1. In your Jupyter Notebook:

    • Using JupyterHub:6 Hard refresh your browser tab.
    • In your own developer environment:7 Restart your notebook.

  2. Then within a code cell or your terminal, run:

    %pip install --upgrade validmind

You may need to restart your kernel after running the upgrade package for changes to be applied.

:::

Additional resources