---
title: Batch Scoring Script
description: The Python batch scoring script is designed to efficiently score large files using the Prediction API. It has been replaced with the Batch Prediction Scripts.

---

# Batch Scoring Script  {: #batch-scoring-script }

!!! warning
    The Python batch scoring script has been deprecated and replaced with the [Batch Prediction Scripts](cli-scripts). While the script can still function in some environments, because legacy Prediction API routes on the prediction servers in the managed AI Platform are disabled, some commands won't work.

The Python batch scoring script is designed to efficiently score large files using the Prediction API. The batch-scoring script only runs against dedicated prediction workers (for managed AI Platform deployments) or a dedicated prediction cluster (for Self-Managed AI Platform users). It achieves greater speed by splitting a CSV input file into optimally sized batches and submitting these concurrently to the prediction server. Batches can be score much more quickly than individual rows. The script handles queueing, resource management, and concurrent request management, requiring no user intervention. Concurrent requests greatly increase the efficiency of the process by using multiple processors to make predictions. However, you should not use a value for `<n>_concurrency` greater than your number of prediction cores. Consult <a target="_blank" href="https://support.datarobot.com">DataRobot Support</a> if you are unsure of how many cores you have.


## Prerequisites {: #prerequisites }

There is a known bug in Python 2.7.8 and later 2.7.x versions that causes SSL connections to fail and so they are not supported. This script supports Python 2.7.7, but Python 3.4 and later are recommended for better speed and text decoding.  You can use Anaconda 2.2.0 or later to install the `datarobot_batch_scoring` script. If you do not have access to the Internet for downloading dependencies, <a target="_blank" href="https://support.datarobot.com">DataRobot Support</a> can provide a bundle that includes everything needed to install offline.

## Installation instructions {: #installation-instructions }

<a target="_blank" href="https://pypi.python.org/pypi/datarobot_batch_scoring">Download and install</a> the DataRobot batch scoring package for Python 2 and 3 using the following command:

	pip install -U datarobot_batch_scoring

## Alternative install methods {: #alternative-install-methods }

DataRobot provides two alternative install methods on the project <a target="_blank" href="https://github.com/datarobot/batch-scoring/releases">releases</a> page. ({% include 'includes/github-sign-in.md' %})
These can help when you do not have:

 * Internet access
 * administrative privileges
 * the Python package manager (pip) installed
 * the correct version of Python installed (use ``PyInstaller``, option 2 below, only)

In any of the above situations, use:

1. **offlinebundle**: For performing installations in environments where Python2.7 or Python3+ is available. Works on Linux, OSX, or Windows. These files have "offlinebundle" in their name on the release page. The install directions are included in the zip or tar file.

2. **PyInstaller**: Using <a target="_blank" href="http://www.pyinstaller.org/">PyInstaller</a>, DataRobot builds a single-file executable that does not depend on Python. It can be installed without administrative privileges. These files on the release page have "executables" in their name, as well as the version and platform (Linux, Windows, or OSX). The install directions are included in the zip or tar file.
Note that the PyInstaller builds for Linux work on distros equal to or newer than Centos 5. Contact <a target="_blank" href="https://support.datarobot.com">DataRobot Support</a> if you have questions or if you have problems getting a build to work on your system.

## Syntax, examples, and usage notes {: #syntax-examples-and-usage-notes }

For complete and up-to-date scoring script syntax and information, visit the DataRobot <a target="_blank" href="https://github.com/datarobot/batch-scoring">batch-scoring Github page</a>. {% include 'includes/github-sign-in.md' %}


### Sample output {: #sample-output }

The `--verbose` output of the script provide information about the progress of the scoring procedure, as shown in the following example. Some particularly informative sections are described below the image.

![](images/dnt-batch-scoring-script-output.png)

* `--host="https://datarobot-xxxxx.datarobot.com"`: Hostname of the prediction API endpoint (the location of the data to use for predictions

* `'user': 'mike@datarobot.com', 'api_token': 'ABCD1234XYZ7890', ...	'datarobot_key': 'xxxxxxxxxxxxxxxxx', ...
	'deployment_id': 'yyyyyyyyyyyyyyyyyy'`: User name and corresponding API key, DataRobot key, and deployment ID
* `batch_scoring v1.16.4`: Script name and version number
* Multiple checks of encoding and dialect with response timing
* `Authorization has succeeded`: Verification that login credentials are valid
* `MainProcess [WARNING] File output.csv exists. Do you want to remove output.csv (Yes/No)> y`: Notification that a file already exists with the specified output name
* `1 responses sent | time elapsed 0.545090913773s`: Time to score submission
