# Blueprint Workshop setup
URL: https://docs.datarobot.com/en/docs/api/code-first-tools/bp-workshop/bp-setup.html

> Learn about the first-time setup necessary for using the Blueprint Workshop.

# 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 API keys and 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]api-quickstart.

> [!NOTE] Note
> If you access DataRobot at `https://app.datarobot.com`, the correct endpoint to specify would be `https://app.datarobot.com/api/v2`. If you have a local installation, update the endpoint accordingly to point at the installation of DataRobot available on your local network.

### 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
```

---
