# tOllamaClient

Available in...

* Cloud Data Fabric
* Data Fabric
* Qlik Talend Cloud Enterprise Edition
* Real-Time Big Data Platform

Accesses the Langchain4j Ollama API. With this component, you can use Ollama models and their different capabilities.

## tOllamaClient Standard properties

These properties are used to configure tOllamaClient running in the Standard Job framework.

The Standard tOllamaClient component belongs to the AI family.

Information noteNote:

* This component is available only when you have installed the 8.0.1-R2025-02 Talend Studio monthly update or a later one delivered by Talend. For more information, check with your administrator.
* As of now, the component only supports versions 3.x of Llama models.

## Prerequisites

Before using this component, you need to:

* Set up the Ollama environment following the [Ollama README instructions](https://github.com/ollama/ollama).
* Install Llama version 3.x in the Ollama environment you set up using the ollama run llama3.x command (replace 3.x with the version of your choice). Refer to the [Ollama README instructions](https://github.com/ollama/ollama).

## Basic settings

| Properties | Description |
| --- | --- |
| Property type | Either Built-in or<br>Repository<br>.<br><br><ul> <li> <span>Built-in</span>: No property data stored                        centrally.</li> <li> <span>Repository</span>: Select the repository                        file in which the properties are stored. The fields that follow are                        completed automatically using the data retrieved.</li> </ul> |
| Schema and Edit Schema | A schema is a row description, it defines the number of fields to be<br>processed and passed on to the next component. The schema is either<br>Built-in or stored remotely in the<br>Repository.<br><br><ul> <li> <p> <span>Built-in</span>: You create and store the schema locally                           for this component only. For more information about a component schema in                           its <span>Basic settings</span> tab, see <a href="https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/basic-settings-tab" target="_blank">Basic settings tab</a>.</p> </li> <li> <p> <span>Repository</span>: You have already                           created the schema and stored it in the <span>Repository</span>. You can reuse it in various projects and Job                           designs. For more information about a component schema in its                              <span>Basic settings</span> tab, see <a href="https://help.qlik.com/talend/r/en-US/8.0/studio-user-guide/basic-settings-tab" target="_blank">Basic settings tab</a>.</p> </li> </ul><br><br>Click Edit<br>schema to make changes to the schema. If the current schema is of the Repository type, three options are available:<br><br><ul> <li> <p> <span>View schema</span>: choose this                option to view the schema only.</p> </li> <li> <p> <span>Change to built-in property</span>:                choose this option to change the schema to <span>Built-in</span> for local changes.</p> </li> <li> <p> <span>Update repository connection</span>:                choose this option to change the schema stored in the repository and decide whether                to propagate the changes to all the Jobs upon completion.</p> <p>If you just want to                propagate the changes to the current Job, you can select <span>No</span> upon completion and choose this schema metadata                again in the <span>Repository Content</span>                window.</p> </li> </ul> |
| Input column | Select the column that must be handled by Ollama. Only one column can be<br>selected at a time.<br><br>This field is available only when the tOllamaClient is not used as an input<br>component and existing columns can be retrieved from the previous component in<br>the Job. |
| Host | Enter the IP address or the hostname. |
| Model | To select one of the available Llama models, click the<br>[...] button next to the field. In the dialog box<br>displayed, select the model that will be used or select the Use custom<br>value check box and specify the model name in the Custom<br>value field.<br><br>As of now, the component supports Llama 3.x<br>models. |
| Prompt | Enter your instructions in this field. For more information on prompt<br>writing best practices, read [How to prompt Code Llama](https://ollama.com/blog/how-to-prompt-code-llama).<br><br>Example: List<br>the top 10 cities corresponding to the given countries, only include city<br>names in the answer. |

## Advanced settings

| Properties | Description |
| --- | --- |
| tStatCatcher Statistics | Select this check box to gather the Job processing metadata at a Job level<br>and at each component level. |
| Connection timeout (ms) | Set the timeout period (in milliseconds) for the component to establish a<br>connection to the server. An error occurs if an attempt to establish a<br>connection fails.<br><br>The default value is 60000, which is equivalent to 60<br>seconds. |

## Global Variables

| Variables | Description |
| --- | --- |
| ERROR\_MESSAGE | ERROR\_MESSAGE: the error message generated by the component when an<br>error occurs. This is an After variable and it returns a string. |
| NB\_LINE | NB\_LINE: the number<br>of rows read by an input component or transferred to an output component. This is an<br>After variable and it returns an integer. |

## Usage

| Usage guidance | Description |
| --- | --- |
| Usage rules | This component cannot handle dynamic columns.<br><br>The component performance<br>depends on the following factors:<br><br><ul> <li>Good prompt writing, see <a href="https://ollama.com/blog/how-to-prompt-code-llama" target="_blank">How to prompt Code Llama</a>.</li> <li> <p>LlaMa model size. For example, <a href="https://ollama.com/library/llama3.2" target="_blank">LLaMa 3.2</a> (3B) is faster than <a href="https://ollama.com/library/llama3.3" target="_blank">LLaMa 3.3</a> (70B).</p> </li> <li>Local machine CPU, memory, and GPU configuration.</li> </ul><br><br>If you switch the usage of this component from an input component<br>to a regular component, you need to adapt the schema and prompt instructions<br>accordingly as the Input column parameter is not<br>displayed for input components. |

**Related tasks**

* [Analyzing customer feedback with Llama text summarization model](https://help.qlik.com/talend/en-US/components/8.0/large-language-model/tollamaclient-tfileinputdelimited-tlogrow-analyzing-customer-feedback "This Job reads customer feedback messages from a CSV file, uses the tOllamaClient component to generate AI-powered summaries and sentiment analysis, and outputs the enriched results to a new file.")