Generate documentation for your model

Published

November 20, 2024

You are now ready to modify the QuickStart notebook you used earlier and run it to generate model documentation and test result with the ValidMind Library. The resulting artifacts are then uploaded to your model documentation in the ValidMind Platform.

Before you begin

Need an account for ValidMind?

Signing up is FREE — Register with ValidMind

Steps

  1. In the left sidebar, go to the Getting Started section of your previously registered model:1

    A screenshot of the landing page for a model with the Getting Started section highlighted in the left sidebar

    Landing page for a model with the Getting Started section highlighted in the left sidebar

    The page that opens provides you with a code snippet to use with the ValidMind Library, including:

    • api_host: The location of the ValidMind API
    • api_key: The account API key
    • api_secret: The account secret key
    • model: The model identifier

    This code snippet can be copied and pasted directly into your developer source code to integrate the library, enabling it to upload to the ValidMind Platform.

    To follow best practices, you can also store the credentials in a .env file2 and pass them in via environment variables.

  2. Locate the code snippet and click Copy snippet to clipboard.

  3. Reopen the QuickStart notebook you accessed earlier.3

  4. In the QuickStart notebook, replace the vm.init() lines that look like the following with your own client integration information from the earlier step when you registered your new model:

    A screenshot showing the QuickStart notebook in Colab with the section to be replaced highlighted

    QuickStart notebook in Colab with the section to be replaced highlighted
  5. Run each cell in the notebook:

    • Hover over each cell and click the icon; OR
    • Press Shift + Enter on Windows or Cmd + Enter if you are on a Mac

    The notebook will guide you through installing the ValidMind Library, initializing the Python environment, and finally connecting the library to the ValidMind Platform.

What’s next

You can now switch back to the platform to view the documentation that has been generated by the library.

Ready to learn more about how you can use ValidMind? Check out Next Steps.