# ML Packages Offline Installation

> Depending on the models you want to use, you need the following:

## Getting started

Depending on the models you want to use, you need the following:

* For models 2022.10 and newer:
  + Download the needed Document Understanding<sup>TM</sup> bundle. [Here](https://docs.uipath.com/document-understanding/automation-suite/2.2510/classic-user-guide/offline-bundles-225100#offline-bundles-225100) are the links for all the available bundles. The du bundle contains information about all models included into a specific version. For example, the `dusemistructured-2.2510.0.tar.gz` contains information about all out-of-the-box pre-trained ML Packages included in the 2.2510.0 version.
* For models 2022.4 and older (`python37duv3` and `python37duv4`):
  + All ML Packages are provided as a `.zip` file which is uploaded directly as a Custom Package in AI Center. To download the models, contact your Account Manager, CSM, or Support to receive a download link per package.
  + Download the needed Document Understanding bundle. [Here](https://docs.uipath.com/document-understanding/automation-suite/2.2510/classic-user-guide/offline-bundles-225100#offline-bundles-225100) are the links for all the available bundles.

:::note
Updated versions for the dulv bundles are no longer released. The latest version for the dulv bundles is [2023.10.4](https://docs.uipath.com/document-understanding/automation-suite/2023.10/classic-user-guide/offline-bundles-2023104).
:::

## Install the offline bundle

Offline installations are requiring that the downloaded du bundle to be renamed in the command line into `du-ondemand.tar.gz`. For instance, if you downloaded the du bundle named `dusemistructured-2.2510.0.tar.gz`, at installation time you need to rename it as `du-ondemand.tar.gz`.

1. For Windows machines, directly download through the bundle link and rename the file to `du-ondemand.tar.gz`
2. For Linux machines, from the machine having access to the internet, download the needed bundle using the following command:
   ```
   wget -O ~/<bundle-name.tar.gz> 'bundle-link'
   ```

   Here's an example of how to download the needed bundle for Linux:

   ```
   wget -O ~/du-ondemand.tar.gz 'https://download.uipath.com/automation-suite/2.2510.0/dusemistructured-2.2510.0.tar.gz'
   ```
3. Copy the following bundle to the `/uipath/tmp` folder on the main machine of the cluster (where the install took place):
   ```
   scp ~/<bundle-name.tar.gz> <username>@<node dns>:/uipath/tmp/
   ```
4. Connect to this main machine and load the bundle:
   ```
   ./configureUiPathAS.sh registry upload --optional-offline-bundle "/uipath/tmp/du.tar.gz" --offline-tmp-folder "/uipath/tmp"
   ```

## Upload the model to AI Center

After downloading and installing the models, follow the steps described in the [ML packages offline installation](https://docs.uipath.com/ai-center/automation-suite/2.2510/user-guide/ml-packages-offline-installation#upload-model-to-ai-center) page from the **AI Center User Guide** to upload them to AI Center. Both ML package `zip` and metadata `json` files are needed for this procedure.

## Form Extractor and Intelligent Keyword Classifier

Access **Form Extractor** and **Intelligent Keyword Classifier**, with the following public URL:

* `<FQDN>/du_/svc/formextractor`
* `<FQDN>/du_/svc/intelligentkeywords`

:::note
When using a public URL, replace the `<FQDN>` placeholder with the actual environment information.For example `<FQDN>/du_/svc/formextractor` becomes `https://servicefabricserver.domain.com/du_/svc/formextractor` when used in a workflow.
:::

## Upload a Document Understanding™ bundle to an external docker registry

Follow these steps to upload a Document Understanding bundle to your external docker registry:

* Pull the desired DU image from the UiPath® registry hosted on **registry.uipath.com**
* Rename the image host as per your docker registry name.
* Push the image to external docker registry

### Pull the desired Document Understanding images

Pull the images from UiPath® registry by running these commands:

```
docker pull <uipath_registry_server>/<image_name>
```

Here's an example of how to pull the image of the UiPathDocumentOCR bundle from a registry called registry.uipath.com:

```
docker pull registry.uipath.com/aicenter/du-doc-ocr:v25.10-10.17-rc04
```

### Rename the image host

Rename the image host by running the following command:

```
docker tag <uipath_registry_server>/<image_name> <your_registry_server>/<image_name>
```

Here's an example of how to rename the image of the UiPathDocumentOCR bundle from a registry called registry.uipath.com to a registry called registory.mycompany.com:

```
docker tag registry.uipath.com/aicenter/du-doc-ocr:v25.10-10.17-rc04 registory.mycompany.com/aicenter/du-doc-ocr:v24.10.0
```

### Push the image to external docker registry

Push the image to your external docker registry by running the following command:

```
docker push <your_registry_server>/<image_name>
```

Here's an example of how to push the image of the UiPathDocumentOCR bundle to an external docker registry:

```
docker push registory.mycompany.com/aicenter/du-doc-ocr:v24.10.0
```

## Images for each Document Understanding bundle

### 2.2510.2

| **Document Understanding Bundle** | **Image** |
| --- | --- |
| **UiPathDocumentOCR** | `aicenter/du-doc-ocr:v25.10-2.26-rc02` |
| **UiPathDocumentOCR_CPU** | `aicenter/du-doc-ocr-cpu:v25.10-2.26-rc02` |
| **Extended Languages OCR** | `du/du-extended-ocr-proxy:v25.10-4.01-rc02`  `du/uipath-ocr-extended:v25.10-4.01-rc02`  `du/du-extended-ocr-reporting:v25.10-4.01-rc02` |
| **DocumentClassifier** | `aicenter/du-ml-document-type-text-classifier:v25.10-2.26-rc02` |
| **Out-of-the-box Pre-trained ML Packages** | `aicenter/du-semistructured:v25.10-2.26-rc02` |

### 2.2510.1

| **Document Understanding Bundle** | **Image** |
| --- | --- |
| **UiPathDocumentOCR** | `aicenter/du-doc-ocr:v25.10-11.30-rc02` |
| **UiPathDocumentOCR_CPU** | `aicenter/du-doc-ocr-cpu:v25.10-11.30-rc02` |
| **Extended Languages OCR** | `du/du-extended-ocr-proxy:v25.10-12.17-rc06`  `du/uipath-ocr-extended:v25.10-12.17-rc06`  `du/du-extended-ocr-reporting:v25.10-12.17-rc06` |
| **DocumentClassifier** | `aicenter/du-ml-document-type-text-classifier:v25.10-11.30-rc02` |
| **Out-of-the-box Pre-trained ML Packages** | `aicenter/du-semistructured:v25.10-11.30-rc02` |

### 2.2510.0

| **Document Understanding Bundle** | **Image** |
| --- | --- |
| **UiPathDocumentOCR** | `aicenter/du-doc-ocr:v25.10-10.17-rc04` |
| **UiPathDocumentOCR_CPU** | `aicenter/du-doc-ocr-cpu:v25.10-10.17-rc04` |
| **Extended Languages OCR** | `du/du-extended-ocr-proxy:v25.10-11.05-rc02`  `du/uipath-ocr-extended:v25.10-11.05-rc02`  `du/du-extended-ocr-reporting:v25.10-11.05-rc02` |
| **DocumentClassifier** | `aicenter/du-ml-document-type-text-classifier:v25.10-10.17-rc04` |
| **Out-of-the-box Pre-trained ML Packages** | `aicenter/du-semistructured:v25.10-10.17-rc04` |