Public Member Functions
void	setNumberOfRetriesForModelPull (int numberOfRetriesForModelPull)

	OllamaAPI ()

	OllamaAPI (String host)

void	setBasicAuth (String username, String password)

void	setBearerAuth (String bearerToken)

boolean	ping ()

ModelsProcessResponse	ps () throws IOException, InterruptedException, OllamaBaseException

List< Model >	listModels () throws OllamaBaseException, IOException, InterruptedException, URISyntaxException

List< LibraryModel >	listModelsFromLibrary () throws OllamaBaseException, IOException, InterruptedException, URISyntaxException

LibraryModelDetail	getLibraryModelDetails (LibraryModel libraryModel) throws OllamaBaseException, IOException, InterruptedException, URISyntaxException

LibraryModelTag	findModelTagFromLibrary (String modelName, String tag) throws OllamaBaseException, IOException, URISyntaxException, InterruptedException

void	pullModel (String modelName) throws OllamaBaseException, IOException, URISyntaxException, InterruptedException

String	getVersion () throws URISyntaxException, IOException, InterruptedException, OllamaBaseException

void	pullModel (LibraryModelTag libraryModelTag) throws OllamaBaseException, IOException, URISyntaxException, InterruptedException

ModelDetail	getModelDetails (String modelName) throws IOException, OllamaBaseException, InterruptedException, URISyntaxException

void	createModelWithFilePath (String modelName, String modelFilePath) throws IOException, InterruptedException, OllamaBaseException, URISyntaxException

void	createModelWithModelFileContents (String modelName, String modelFileContents) throws IOException, InterruptedException, OllamaBaseException, URISyntaxException

void	createModel (CustomModelRequest customModelRequest) throws IOException, InterruptedException, OllamaBaseException, URISyntaxException

void	deleteModel (String modelName, boolean ignoreIfNotPresent) throws IOException, InterruptedException, OllamaBaseException, URISyntaxException

List< Double >	generateEmbeddings (String model, String prompt) throws IOException, InterruptedException, OllamaBaseException

List< Double >	generateEmbeddings (OllamaEmbeddingsRequestModel modelRequest) throws IOException, InterruptedException, OllamaBaseException

OllamaEmbedResponseModel	embed (String model, List< String > inputs) throws IOException, InterruptedException, OllamaBaseException

OllamaEmbedResponseModel	embed (OllamaEmbedRequestModel modelRequest) throws IOException, InterruptedException, OllamaBaseException

OllamaResult	generate (String model, String prompt, boolean raw, Options options, OllamaStreamHandler streamHandler) throws OllamaBaseException, IOException, InterruptedException

OllamaResult	generate (String model, String prompt, Map< String, Object > format) throws OllamaBaseException, IOException, InterruptedException

OllamaResult	generate (String model, String prompt, boolean raw, Options options) throws OllamaBaseException, IOException, InterruptedException

OllamaToolsResult	generateWithTools (String model, String prompt, Options options) throws OllamaBaseException, IOException, InterruptedException, ToolInvocationException

OllamaAsyncResultStreamer	generateAsync (String model, String prompt, boolean raw)

OllamaResult	generateWithImageFiles (String model, String prompt, List< File > imageFiles, Options options, OllamaStreamHandler streamHandler) throws OllamaBaseException, IOException, InterruptedException

OllamaResult	generateWithImageFiles (String model, String prompt, List< File > imageFiles, Options options) throws OllamaBaseException, IOException, InterruptedException

OllamaResult	generateWithImageURLs (String model, String prompt, List< String > imageURLs, Options options, OllamaStreamHandler streamHandler) throws OllamaBaseException, IOException, InterruptedException, URISyntaxException

OllamaResult	generateWithImageURLs (String model, String prompt, List< String > imageURLs, Options options) throws OllamaBaseException, IOException, InterruptedException, URISyntaxException

OllamaResult	generateWithImages (String model, String prompt, List< byte[]> images, Options options, OllamaStreamHandler streamHandler) throws OllamaBaseException, IOException, InterruptedException

OllamaResult	generateWithImages (String model, String prompt, List< byte[]> images, Options options) throws OllamaBaseException, IOException, InterruptedException

OllamaChatResult	chat (String model, List< OllamaChatMessage > messages) throws OllamaBaseException, IOException, InterruptedException, ToolInvocationException

OllamaChatResult	chat (OllamaChatRequest request) throws OllamaBaseException, IOException, InterruptedException, ToolInvocationException

OllamaChatResult	chat (OllamaChatRequest request, OllamaStreamHandler streamHandler) throws OllamaBaseException, IOException, InterruptedException, ToolInvocationException

OllamaChatResult	chatStreaming (OllamaChatRequest request, OllamaTokenHandler tokenHandler) throws OllamaBaseException, IOException, InterruptedException, ToolInvocationException

void	registerTool (Tools.ToolSpecification toolSpecification)

void	registerTools (List< Tools.ToolSpecification > toolSpecifications)

void	registerAnnotatedTools ()

void	registerAnnotatedTools (Object object)

OllamaChatMessageRole	addCustomRole (String roleName)

List< OllamaChatMessageRole >	listRoles ()

OllamaChatMessageRole	getRole (String roleName) throws RoleNotFoundException

Detailed Description

The base Ollama API class.

Definition at line 55 of file OllamaAPI.java.

Constructor & Destructor Documentation

◆ OllamaAPI() [1/2]

io.github.ollama4j.OllamaAPI.OllamaAPI ( )

Instantiates the Ollama API with default Ollama host: http://localhost:11434

Definition at line 89 of file OllamaAPI.java.

◆ OllamaAPI() [2/2]

io.github.ollama4j.OllamaAPI.OllamaAPI ( String host )

Instantiates the Ollama API with specified Ollama host address.

Parameters

host	the host address of Ollama server

Definition at line 98 of file OllamaAPI.java.

Member Function Documentation

◆ addCustomRole()

OllamaChatMessageRole io.github.ollama4j.OllamaAPI.addCustomRole ( String roleName )

Adds a custom role.

Parameters

roleName the name of the custom role to be added

Returns: the newly created OllamaChatMessageRole

Definition at line 1320 of file OllamaAPI.java.

◆ chat() [1/3]

OllamaChatResult io.github.ollama4j.OllamaAPI.chat ( OllamaChatRequest request ) throws OllamaBaseException, IOException, InterruptedException, ToolInvocationException

Ask a question to a model using an OllamaChatRequest. This can be constructed using an OllamaChatRequestBuilder.

Hint: the OllamaChatRequestModel#getStream() property is not implemented.

Parameters

request request object to be sent to the server

Returns: OllamaChatResult

Exceptions

OllamaBaseException	any response code than 200 has been returned
IOException	in case the responseStream can not be read
InterruptedException	in case the server is not reachable or network issues happen
OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
ToolInvocationException	if the tool invocation fails

Definition at line 1094 of file OllamaAPI.java.

◆ chat() [2/3]

OllamaChatResult io.github.ollama4j.OllamaAPI.chat	(	OllamaChatRequest	request,
		OllamaStreamHandler	streamHandler ) throws OllamaBaseException, IOException, InterruptedException, ToolInvocationException

Ask a question to a model using an OllamaChatRequest. This can be constructed using an OllamaChatRequestBuilder.

Hint: the OllamaChatRequestModel#getStream() property is not implemented.

Parameters

request	request object to be sent to the server
streamHandler	callback handler to handle the last message from stream (caution: all previous tokens from stream will be concatenated)

Returns: OllamaChatResult

Exceptions

OllamaBaseException	any response code than 200 has been returned
IOException	in case the responseStream can not be read
InterruptedException	in case the server is not reachable or network issues happen
OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
ToolInvocationException	if the tool invocation fails

Definition at line 1119 of file OllamaAPI.java.

◆ chat() [3/3]

OllamaChatResult io.github.ollama4j.OllamaAPI.chat	(	String	model,
		List< OllamaChatMessage >	messages ) throws OllamaBaseException, IOException, InterruptedException, ToolInvocationException

Ask a question to a model based on a given message stack (i.e. a chat history). Creates a synchronous call to the api 'api/chat'.

Parameters

model	the ollama model to ask the question to
messages	chat history / message stack to send to the model

Returns: OllamaChatResult containing the api response and the message history including the newly acquired assistant response.

Exceptions

OllamaBaseException	any response code than 200 has been returned
IOException	in case the responseStream can not be read
InterruptedException	in case the server is not reachable or network issues happen
OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
ToolInvocationException	if the tool invocation fails

Definition at line 1071 of file OllamaAPI.java.

◆ chatStreaming()

OllamaChatResult io.github.ollama4j.OllamaAPI.chatStreaming	(	OllamaChatRequest	request,
		OllamaTokenHandler	tokenHandler ) throws OllamaBaseException, IOException, InterruptedException, ToolInvocationException

Ask a question to a model using an OllamaChatRequest. This can be constructed using an OllamaChatRequestBuilder.

Hint: the OllamaChatRequestModel#getStream() property is not implemented.

Parameters

request	request object to be sent to the server
tokenHandler	callback handler to handle the last token from stream (caution: the previous tokens from stream will not be concatenated)

Returns: OllamaChatResult

Exceptions

OllamaBaseException	any response code than 200 has been returned
IOException	in case the responseStream can not be read
InterruptedException	in case the server is not reachable or network issues happen
OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted

Definition at line 1143 of file OllamaAPI.java.

◆ createModel()

void io.github.ollama4j.OllamaAPI.createModel ( CustomModelRequest customModelRequest ) throws IOException, InterruptedException, OllamaBaseException, URISyntaxException

Create a custom model. Read more about custom model creation here.

Parameters

customModelRequest custom model spec

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
URISyntaxException	if the URI for the request is malformed

Definition at line 594 of file OllamaAPI.java.

◆ createModelWithFilePath()

void io.github.ollama4j.OllamaAPI.createModelWithFilePath	(	String	modelName,
		String	modelFilePath ) throws IOException, InterruptedException, OllamaBaseException, URISyntaxException

Create a custom model from a model file. Read more about custom model file creation here.

Parameters

modelName	the name of the custom model to be created.
modelFilePath	the path to model file that exists on the Ollama server.

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
URISyntaxException	if the URI for the request is malformed

Definition at line 521 of file OllamaAPI.java.

◆ createModelWithModelFileContents()

void io.github.ollama4j.OllamaAPI.createModelWithModelFileContents	(	String	modelName,
		String	modelFileContents ) throws IOException, InterruptedException, OllamaBaseException, URISyntaxException

Create a custom model from a model file. Read more about custom model file creation here.

Parameters

modelName	the name of the custom model to be created.
modelFileContents	the path to model file that exists on the Ollama server.

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
URISyntaxException	if the URI for the request is malformed

Definition at line 561 of file OllamaAPI.java.

◆ deleteModel()

void io.github.ollama4j.OllamaAPI.deleteModel	(	String	modelName,
		boolean	ignoreIfNotPresent ) throws IOException, InterruptedException, OllamaBaseException, URISyntaxException

Delete a model from Ollama server.

Parameters

modelName	the name of the model to be deleted.
ignoreIfNotPresent	ignore errors if the specified model is not present on Ollama server.

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
URISyntaxException	if the URI for the request is malformed

Definition at line 627 of file OllamaAPI.java.

◆ embed() [1/2]

OllamaEmbedResponseModel io.github.ollama4j.OllamaAPI.embed ( OllamaEmbedRequestModel modelRequest ) throws IOException, InterruptedException, OllamaBaseException

Generate embeddings using a OllamaEmbedRequestModel.

Parameters

modelRequest request for '/api/embed' endpoint

Returns: embeddings

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted

Definition at line 718 of file OllamaAPI.java.

◆ embed() [2/2]

OllamaEmbedResponseModel io.github.ollama4j.OllamaAPI.embed	(	String	model,
		List< String >	inputs ) throws IOException, InterruptedException, OllamaBaseException

Generate embeddings for a given text from a model

Parameters

model	name of model to generate embeddings from
inputs	text/s to generate embeddings for

Returns: embeddings

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted

Definition at line 704 of file OllamaAPI.java.

◆ findModelTagFromLibrary()

LibraryModelTag io.github.ollama4j.OllamaAPI.findModelTagFromLibrary	(	String	modelName,
		String	tag ) throws OllamaBaseException, IOException, URISyntaxException, InterruptedException

Finds a specific model using model name and tag from Ollama library.

This method retrieves the model from the Ollama library by its name, then fetches its tags. It searches through the tags of the model to find one that matches the specified tag name. If the model or the tag is not found, it throws a NoSuchElementException.

Parameters

modelName	The name of the model to search for in the library.
tag	The tag name to search for within the specified model.

Returns: The LibraryModelTag associated with the specified model and tag.

Exceptions

OllamaBaseException	If there is a problem with the Ollama library operations.
IOException	If an I/O error occurs during the operation.
URISyntaxException	If there is an error with the URI syntax.
InterruptedException	If the operation is interrupted.
NoSuchElementException	If the model or the tag is not found.

Definition at line 359 of file OllamaAPI.java.

◆ generate() [1/3]

OllamaResult io.github.ollama4j.OllamaAPI.generate	(	String	model,
		String	prompt,
		boolean	raw,
		Options	options ) throws OllamaBaseException, IOException, InterruptedException

Generates response using the specified AI model and prompt (in blocking mode).

Uses generate(String, String, boolean, Options, OllamaStreamHandler)

Parameters

model	The name or identifier of the AI model to use for generating the response.
prompt	The input text or prompt to provide to the AI model.
raw	In some cases, you may wish to bypass the templating system and provide a full prompt. In this case, you can use the raw parameter to disable templating. Also note that raw mode will not return a context.
options	Additional options or configurations to use when generating the response.

Returns: OllamaResult

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted

Definition at line 832 of file OllamaAPI.java.

◆ generate() [2/3]

OllamaResult io.github.ollama4j.OllamaAPI.generate	(	String	model,
		String	prompt,
		boolean	raw,
		Options	options,
		OllamaStreamHandler	streamHandler ) throws OllamaBaseException, IOException, InterruptedException

Generate response for a question to a model running on Ollama server. This is a sync/blocking call.

Parameters

model	the ollama model to ask the question to
prompt	the prompt/question text
options	the Options object - More details on the options
streamHandler	optional callback consumer that will be applied every time a streamed response is received. If not set, the stream parameter of the request is set to false.

Returns: OllamaResult that includes response text and time taken for response

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted

Definition at line 757 of file OllamaAPI.java.

◆ generate() [3/3]

OllamaResult io.github.ollama4j.OllamaAPI.generate	(	String	model,
		String	prompt,
		Map< String, Object >	format ) throws OllamaBaseException, IOException, InterruptedException

Generates structured output from the specified AI model and prompt.

Parameters

model	The name or identifier of the AI model to use for generating the response.
prompt	The input text or prompt to provide to the AI model.
format	A map containing the format specification for the structured output.

Returns: An instance of OllamaResult containing the structured response.

Exceptions

OllamaBaseException	if the response indicates an error status.
IOException	if an I/O error occurs during the HTTP request.
InterruptedException	if the operation is interrupted.

Definition at line 779 of file OllamaAPI.java.

◆ generateAsync()

OllamaAsyncResultStreamer io.github.ollama4j.OllamaAPI.generateAsync	(	String	model,
		String	prompt,
		boolean	raw )

Generate response for a question to a model running on Ollama server and get a callback handle that can be used to check for status and get the response from the model later. This would be an async/non-blocking call.

Parameters

model	the ollama model to ask the question to
prompt	the prompt/question text

Returns: the ollama async result callback handle

Definition at line 910 of file OllamaAPI.java.

◆ generateEmbeddings() [1/2]

List< Double > io.github.ollama4j.OllamaAPI.generateEmbeddings ( OllamaEmbeddingsRequestModel modelRequest ) throws IOException, InterruptedException, OllamaBaseException

Generate embeddings using a OllamaEmbeddingsRequestModel.

Parameters

modelRequest request for '/api/embeddings' endpoint

Returns: embeddings

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted

Deprecated: Use embed(OllamaEmbedRequestModel) instead.

Definition at line 674 of file OllamaAPI.java.

◆ generateEmbeddings() [2/2]

List< Double > io.github.ollama4j.OllamaAPI.generateEmbeddings	(	String	model,
		String	prompt ) throws IOException, InterruptedException, OllamaBaseException

Generate embeddings for a given text from a model

Parameters

model	name of model to generate embeddings from
prompt	text to generate embeddings for

Returns: embeddings

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted

Deprecated: Use embed(String, List) instead.

Definition at line 658 of file OllamaAPI.java.

◆ generateWithImageFiles() [1/2]

OllamaResult io.github.ollama4j.OllamaAPI.generateWithImageFiles	(	String	model,
		String	prompt,
		List< File >	imageFiles,
		Options	options ) throws OllamaBaseException, IOException, InterruptedException

Convenience method to call Ollama API without streaming responses.

Uses generateWithImageFiles(String, String, List, Options, OllamaStreamHandler)

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted

Definition at line 961 of file OllamaAPI.java.

◆ generateWithImageFiles() [2/2]

OllamaResult io.github.ollama4j.OllamaAPI.generateWithImageFiles	(	String	model,
		String	prompt,
		List< File >	imageFiles,
		Options	options,
		OllamaStreamHandler	streamHandler ) throws OllamaBaseException, IOException, InterruptedException

With one or more image files, ask a question to a model running on Ollama server. This is a sync/blocking call.

Parameters

model	the ollama model to ask the question to
prompt	the prompt/question text
imageFiles	the list of image files to use for the question
options	the Options object - More details on the options
streamHandler	optional callback consumer that will be applied every time a streamed response is received. If not set, the stream parameter of the request is set to false.

Returns: OllamaResult that includes response text and time taken for response

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted

Definition at line 940 of file OllamaAPI.java.

◆ generateWithImages() [1/2]

OllamaResult io.github.ollama4j.OllamaAPI.generateWithImages	(	String	model,
		String	prompt,
		List< byte[]>	images,
		Options	options ) throws OllamaBaseException, IOException, InterruptedException

Convenience method to call the Ollama API using image byte arrays without streaming responses.

Uses generateWithImages(String, String, List, Options, OllamaStreamHandler)

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted

Definition at line 1049 of file OllamaAPI.java.

◆ generateWithImages() [2/2]

OllamaResult io.github.ollama4j.OllamaAPI.generateWithImages	(	String	model,
		String	prompt,
		List< byte[]>	images,
		Options	options,
		OllamaStreamHandler	streamHandler ) throws OllamaBaseException, IOException, InterruptedException

Synchronously generates a response using a list of image byte arrays.

This method encodes the provided byte arrays into Base64 and sends them to the Ollama server.

Parameters

model	the Ollama model to use for generating the response
prompt	the prompt or question text to send to the model
images	the list of image data as byte arrays
options	the Options object - More details on the options
streamHandler	optional callback that will be invoked with each streamed response; if null, streaming is disabled

Returns: OllamaResult containing the response text and the time taken for the response

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted

Definition at line 1030 of file OllamaAPI.java.

◆ generateWithImageURLs() [1/2]

OllamaResult io.github.ollama4j.OllamaAPI.generateWithImageURLs	(	String	model,
		String	prompt,
		List< String >	imageURLs,
		Options	options ) throws OllamaBaseException, IOException, InterruptedException, URISyntaxException

Convenience method to call Ollama API without streaming responses.

Uses generateWithImageURLs(String, String, List, Options, OllamaStreamHandler)

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
URISyntaxException	if the URI for the request is malformed

Definition at line 1010 of file OllamaAPI.java.

◆ generateWithImageURLs() [2/2]

OllamaResult io.github.ollama4j.OllamaAPI.generateWithImageURLs	(	String	model,
		String	prompt,
		List< String >	imageURLs,
		Options	options,
		OllamaStreamHandler	streamHandler ) throws OllamaBaseException, IOException, InterruptedException, URISyntaxException

With one or more image URLs, ask a question to a model running on Ollama server. This is a sync/blocking call.

Parameters

model	the ollama model to ask the question to
prompt	the prompt/question text
imageURLs	the list of image URLs to use for the question
options	the Options object - More details on the options
streamHandler	optional callback consumer that will be applied every time a streamed response is received. If not set, the stream parameter of the request is set to false.

Returns: OllamaResult that includes response text and time taken for response

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
URISyntaxException	if the URI for the request is malformed

Definition at line 987 of file OllamaAPI.java.

◆ generateWithTools()

OllamaToolsResult io.github.ollama4j.OllamaAPI.generateWithTools	(	String	model,
		String	prompt,
		Options	options ) throws OllamaBaseException, IOException, InterruptedException, ToolInvocationException

Generates response using the specified AI model and prompt (in blocking mode), and then invokes a set of tools on the generated response.

Parameters

model	The name or identifier of the AI model to use for generating the response.
prompt	The input text or prompt to provide to the AI model.
options	Additional options or configurations to use when generating the response.

Returns: OllamaToolsResult An OllamaToolsResult object containing the response from the AI model and the results of invoking the tools on that output.

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted

Definition at line 854 of file OllamaAPI.java.

◆ getLibraryModelDetails()

LibraryModelDetail io.github.ollama4j.OllamaAPI.getLibraryModelDetails ( LibraryModel libraryModel ) throws OllamaBaseException, IOException, InterruptedException, URISyntaxException

Fetches the tags associated with a specific model from Ollama library. This method fetches the available model tags directly from Ollama library model page, including model tag name, size and time when model was last updated into a list of LibraryModelTag objects.

Parameters

libraryModel the LibraryModel object which contains the name of the library model for which the tags need to be fetched.

Returns: a list of LibraryModelTag objects containing the extracted tags and their associated metadata.

Exceptions

OllamaBaseException	if the HTTP response status code indicates an error (i.e., not 200 OK), or if there is any other issue during the request or response processing.
IOException	if an input/output exception occurs during the HTTP request or response handling.
InterruptedException	if the thread is interrupted while waiting for the HTTP response.
URISyntaxException	if the URI format is incorrect or invalid.

Definition at line 295 of file OllamaAPI.java.

◆ getModelDetails()

ModelDetail io.github.ollama4j.OllamaAPI.getModelDetails ( String modelName ) throws IOException, OllamaBaseException, InterruptedException, URISyntaxException

Gets model details from the Ollama server.

Parameters

modelName the model

Returns: the model details

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
URISyntaxException	if the URI for the request is malformed

Definition at line 490 of file OllamaAPI.java.

◆ getRole()

OllamaChatMessageRole io.github.ollama4j.OllamaAPI.getRole ( String roleName ) throws RoleNotFoundException

Retrieves a specific role by name.

Parameters

roleName the name of the role to retrieve

Returns: the OllamaChatMessageRole associated with the given name

Exceptions

RoleNotFoundException if the role with the specified name does not exist

Definition at line 1341 of file OllamaAPI.java.

◆ getVersion()

String io.github.ollama4j.OllamaAPI.getVersion ( ) throws URISyntaxException, IOException, InterruptedException, OllamaBaseException

Definition at line 445 of file OllamaAPI.java.

◆ listModels()

List< Model > io.github.ollama4j.OllamaAPI.listModels ( ) throws OllamaBaseException, IOException, InterruptedException, URISyntaxException

Lists available models from the Ollama server.

Returns: a list of models available on the server

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
URISyntaxException	if the URI for the request is malformed

Definition at line 196 of file OllamaAPI.java.

◆ listModelsFromLibrary()

List< LibraryModel > io.github.ollama4j.OllamaAPI.listModelsFromLibrary ( ) throws OllamaBaseException, IOException, InterruptedException, URISyntaxException

Retrieves a list of models from the Ollama library. This method fetches the available models directly from Ollama library page, including model details such as the name, pull count, popular tags, tag count, and the time when model was updated.

Returns: A list of LibraryModel objects representing the models available in the Ollama library.

Exceptions

OllamaBaseException	If the HTTP request fails or the response is not successful (non-200 status code).
IOException	If an I/O error occurs during the HTTP request or response processing.
InterruptedException	If the thread executing the request is interrupted.
URISyntaxException	If there is an error creating the URI for the HTTP request.

Definition at line 228 of file OllamaAPI.java.

◆ listRoles()

List< OllamaChatMessageRole > io.github.ollama4j.OllamaAPI.listRoles ( )

Lists all available roles.

Returns: a list of available OllamaChatMessageRole objects

Definition at line 1329 of file OllamaAPI.java.

◆ ping()

boolean io.github.ollama4j.OllamaAPI.ping ( )

API to check the reachability of Ollama server.

Returns: true if the server is reachable, false otherwise.

Definition at line 135 of file OllamaAPI.java.

◆ ps()

ModelsProcessResponse io.github.ollama4j.OllamaAPI.ps ( ) throws IOException, InterruptedException, OllamaBaseException

Provides a list of running models and details about each model currently loaded into memory.

Returns: ModelsProcessResponse containing details about the running models

Exceptions

IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
OllamaBaseException	if the response indicates an error status

Definition at line 166 of file OllamaAPI.java.

◆ pullModel() [1/2]

void io.github.ollama4j.OllamaAPI.pullModel ( LibraryModelTag libraryModelTag ) throws OllamaBaseException, IOException, URISyntaxException, InterruptedException

Pulls a model using the specified Ollama library model tag. The model is identified by a name and a tag, which are combined into a single identifier in the format "name:tag" to pull the corresponding model.

Parameters

libraryModelTag the LibraryModelTag object containing the name and tag of the model to be pulled.

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
URISyntaxException	if the URI for the request is malformed

Definition at line 474 of file OllamaAPI.java.

◆ pullModel() [2/2]

void io.github.ollama4j.OllamaAPI.pullModel ( String modelName ) throws OllamaBaseException, IOException, URISyntaxException, InterruptedException

Pull a model on the Ollama server from the list of available models.

Parameters

modelName the name of the model

Exceptions

OllamaBaseException	if the response indicates an error status
IOException	if an I/O error occurs during the HTTP request
InterruptedException	if the operation is interrupted
URISyntaxException	if the URI for the request is malformed

Definition at line 383 of file OllamaAPI.java.

◆ registerAnnotatedTools() [1/2]

void io.github.ollama4j.OllamaAPI.registerAnnotatedTools ( )

Registers tools based on the annotations found on the methods of the caller's class and its providers. This method scans the caller's class for the OllamaToolService annotation and recursively registers annotated tools from all the providers specified in the annotation.

Exceptions

IllegalStateException	if the caller's class is not annotated with `OllamaToolService`.
RuntimeException	if any reflection-based instantiation or invocation fails.

Definition at line 1231 of file OllamaAPI.java.

◆ registerAnnotatedTools() [2/2]

void io.github.ollama4j.OllamaAPI.registerAnnotatedTools ( Object object )

Registers tools based on the annotations found on the methods of the provided object. This method scans the methods of the given object and registers tools using the ToolSpec annotation and associated ToolProperty annotations. It constructs tool specifications and stores them in a tool registry.

Parameters

object the object whose methods are to be inspected for annotated tools.

Exceptions

RuntimeException if any reflection-based instantiation or invocation fails.

Definition at line 1268 of file OllamaAPI.java.

◆ registerTool()

void io.github.ollama4j.OllamaAPI.registerTool ( Tools.ToolSpecification toolSpecification )

Registers a single tool in the tool registry using the provided tool specification.

Parameters

toolSpecification the specification of the tool to register. It contains the tool's function name and other relevant information.

Definition at line 1196 of file OllamaAPI.java.

◆ registerTools()

void io.github.ollama4j.OllamaAPI.registerTools ( List< Tools.ToolSpecification > toolSpecifications )

Registers multiple tools in the tool registry using a list of tool specifications. Iterates over the list and adds each tool specification to the registry.

Parameters

toolSpecifications a list of tool specifications to register. Each specification contains information about a tool, such as its function name.

Definition at line 1213 of file OllamaAPI.java.

◆ setBasicAuth()

void io.github.ollama4j.OllamaAPI.setBasicAuth	(	String	username,
		String	password )

Set basic authentication for accessing Ollama server that's behind a reverse-proxy/gateway.

Parameters

username	the username
password	the password

Definition at line 116 of file OllamaAPI.java.

◆ setBearerAuth()

void io.github.ollama4j.OllamaAPI.setBearerAuth ( String bearerToken )

Set Bearer authentication for accessing Ollama server that's behind a reverse-proxy/gateway.

Parameters

bearerToken the Bearer authentication token to provide

Definition at line 126 of file OllamaAPI.java.

◆ setNumberOfRetriesForModelPull()

void io.github.ollama4j.OllamaAPI.setNumberOfRetriesForModelPull ( int numberOfRetriesForModelPull )

Definition at line 79 of file OllamaAPI.java.

The documentation for this class was generated from the following file:

src/main/java/io/github/ollama4j/OllamaAPI.java

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ OllamaAPI() [1/2]

◆ OllamaAPI() [2/2]

Member Function Documentation

◆ addCustomRole()

◆ chat() [1/3]

◆ chat() [2/3]

◆ chat() [3/3]

◆ chatStreaming()

◆ createModel()

◆ createModelWithFilePath()

◆ createModelWithModelFileContents()

◆ deleteModel()

◆ embed() [1/2]

◆ embed() [2/2]

◆ findModelTagFromLibrary()

◆ generate() [1/3]

◆ generate() [2/3]

◆ generate() [3/3]

◆ generateAsync()

◆ generateEmbeddings() [1/2]

◆ generateEmbeddings() [2/2]

◆ generateWithImageFiles() [1/2]

◆ generateWithImageFiles() [2/2]

◆ generateWithImages() [1/2]

◆ generateWithImages() [2/2]

◆ generateWithImageURLs() [1/2]

◆ generateWithImageURLs() [2/2]

◆ generateWithTools()

◆ getLibraryModelDetails()

◆ getModelDetails()

◆ getRole()

◆ getVersion()

◆ listModels()

◆ listModelsFromLibrary()

◆ listRoles()

◆ ping()

◆ ps()

◆ pullModel() [1/2]

◆ pullModel() [2/2]

◆ registerAnnotatedTools() [1/2]

◆ registerAnnotatedTools() [2/2]

◆ registerTool()

◆ registerTools()

◆ setBasicAuth()

◆ setBearerAuth()

◆ setNumberOfRetriesForModelPull()