Blueprint Workshop setup¶

This page explains how to configure the Blueprint Workshop, including installing the required libraries, enabling your DataRobot account, and establishing a connection to DataRobot by providing credentials.

Installation¶

Run the following steps to install the Blueprint Workshop.

1. mkvirtualenv -p python3.7 blueprint-workshop
2. sudo apt-get install graphviz or brew install graphviz
3. pip install datarobot-bp-workshop

Connect to DataRobot¶

Use the following sections to connect to DataRobot in order to use the Blueprint Workshop. Each authentication method below specifies credentials for DataRobot, as well as the location of the DataRobot deployment. DataRobot currently supports configuration using a configuration file, by setting environment variables, or within the code itself.

Credentials¶

Specify an API token and an endpoint in order to use the client. You can manage your API tokens in the DataRobot application by selecting your profile and navigating to Developer Tools. The order of precedence is as follows. Note that the first available option will be used.

1. Set an endpoint and API key in code using datarobot.Client.
2. Set up a config file as specified directly using datarobot.Client.
3. Set up a config file as specified by the environment variable DATAROBOT_CONFIG_FILE.
4. Configure the environment variables DATAROBOT_ENDPOINT and DATAROBOT_API_TOKEN.
5. Search for a config file in the home directory of the current user, at ~/.config/datarobot/drconfig.yaml.

For more information, read about the different options for connecting to DataRobot from the Python client.

Set credentials in code¶

To set credentials explicitly in code:

import datarobot as dr
dr.Client(token='your_token', endpoint='https://app.datarobot.com/api/v2')

You can also point to a YAML config file to use:

import datarobot as dr
dr.Client(config_path='/home/user/my_datarobot_config.yaml')

Use a configuration file¶

You can use a configuration file to specify the client setup. The following is an example configuration file that should be saved as ~/.config/datarobot/drconfig.yaml:

token: yourtoken
endpoint: https://app.datarobot.com/api/v2

You can specify a different location for the DataRobot configuration file by setting the DATAROBOT_CONFIG_FILE environment variable. Note that if you specify a file path, you should use an absolute path so that the API client will work when run from any location.

Set credentials using environment variables¶

Set up an endpoint by setting environment variables in the UNIX shell:

export DATAROBOT_ENDPOINT='https://app.datarobot.com/api/v2'
export DATAROBOT_API_TOKEN=your_token