ollama-multirun: this_is_the_ollama_bash_lib_bash_script

Prompt: (raw) (yaml) words:845 bytes:5895

This is the Ollama Bash Lib Bash script.
Act as an expert Software Engineer.
Do a full code review of this script:

#!/usr/bin/env bash
#
# Ollama Bash Lib - A Bash Library to interact with Ollama
#

OLLAMA_BASH_LIB_NAME="Ollama Bash Lib"
OLLAMA_BASH_LIB_VERSION="0.16"
OLLAMA_BASH_LIB_URL="https://github.com/attogram/ollama-bash-lib"
OLLAMA_BASH_LIB_LICENSE="MIT"
OLLAMA_BASH_LIB_COPYRIGHT="Copyright (c) 2025 Attogram Project <https://github.com/attogram>"
OLLAMA_BASH_LIB_DEBUG=0
OLLAMA_BASH_LIB_API=${OLLAMA_HOST:-"http://localhost:11434"} # no slash at end
RETURN_SUCCESS=0
RETURN_ERROR=1

# Debug message
#
# Usage: debug "message"
# Output: message to stderr
# Returns: none
debug() {
  if [ "$OLLAMA_BASH_LIB_DEBUG" == "1" ]; then
    >&2 echo -e "[DEBUG] $1"
  fi
}

# Is Ollama installed on the local system?
#
# Usage: if ollamaIsInstalled; then echo "Ollama Installed"; else echo "Ollama Not Installed"; fi
# Output: none
# Returns: 0 if Ollama is installed, 1 if Ollama is not installed
ollamaIsInstalled() {
  debug "ollamaIsInstalled"
  if [ -z "$(command -v "ollama" 2> /dev/null)" ]; then
    return $RETURN_ERROR
  fi
  return $RETURN_SUCCESS
}

# Escape a string for inclusion into JSON
#
# Usage: safeJson "string"
# Output: "quoted safe json value"
# Returns: 0 on success, 1 on error
safeJson() {
  debug "safeJson: $1"
  jq -Rn --arg str "$1" '$str'
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# GET request to the Ollama API
#
# Usage: ollamaApiGet "/api/command"
# Output: result of API call
# Returns: 0 on success, 1 on error
ollamaApiGet() {
  debug "ollamaApiGet: $1"
  curl -s -X GET "${OLLAMA_BASH_LIB_API}$1" -H 'Content-Type: application/json' -d ''
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# POST request to the Ollama API
#
# Usage: ollamaApiPost "/api/command" "{ json content }"
# Output: result of API call
# Returns: 0 on success, 1 on error
ollamaApiPost() {
  debug "ollamaApiPost: $1 $2"
  curl -s -X POST "${OLLAMA_BASH_LIB_API}$1" -H 'Content-Type: application/json' -d "$2"
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# Unload a model from memory (Clear context for a model)
#
# Usage: ollamaClearModel "modelName"
# Output: none
# Returns: 0 on success, 1 on error
ollamaClearModel() {
  if [ -z "$1" ]; then
    debug "Error: ollamaClearModel: no model"
    return $RETURN_ERROR
  fi
  local response
  response=$(ollamaApiPost "/api/generate" "{\"model\": \"$1\", \"keep_alive\": 0}")
  debug "$response"
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# Generate a completion, non-streaming
#
# Usage: ollamaGenerate "modelName" "prompt"
# Output: json
# Returns: 0 on success, 1 on error
ollamaGenerate() {
  debug "ollamaGenerate: $1 $2"
  ollamaApiPost "/api/generate" "{\"model\": \"$1\", \"prompt\": $(safeJson "$2"), \"stream\": false}"
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# Generate a completion, streaming
#
# Usage: ollamaGenerateStreaming "modelName" "prompt"
# Output: json
# Returns: 0 on success, 1 on error
ollamaGenerateStreaming() {
  debug "ollamaGenerateStreaming: $1 $2"
  ollamaApiPost "/api/generate" "{\"model\": \"$1\", \"prompt\": $(safeJson "$2")}"
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# All available models, cli version
#
# Usage: ollamaList
# Output: text
# Returns: 0 on success, 1 on error
ollamaList() {
  ollama list
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# All available models, JSON version
#
# Usage: ollamaListJson
# Output: json
# Returns: 0 on success, 1 on error
ollamaListJson() {
  ollamaApiGet "/api/tags"
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# All available models, Bash array version
#
# Usage: models=($(ollamaListArray))
# Output: space separated list of model names
# Returns: 0 on success, 1 on error
ollamaListArray() {
  models=($(ollama list | awk '{if (NR > 1) print $1}' | sort)) # Get list of models, sorted alphabetically
  echo "${models[@]}"
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# Get a random model
#
# Usage: ollamaGetRandomModel
# Output: 1 model name
# Returns: 0 on success, 1 on error
ollamaGetRandomModel() {
  debug "ollamaGetRandomModel"
  local models=($(ollamaListArray))
  echo "${models[RANDOM%${#models[@]}]}"
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# Running model processes, cli version
#
# Usage: ollamaPs
# Output: text
# Returns: 0 on success, 1 on error
ollamaPs() {
  ollama ps
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# Running model processes, JSON version
#
# Usage: ollamaPsJson
# Output: json
# Returns: 0 on success, 1 on error
ollamaPsJson() {
  ollamaApiGet "/api/ps"
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# Show model information, cli version
#
# Usage: ollamaShow "modelName"
# Output: text
# Returns: 0 on success, 1 on error
ollamaShow() {
  ollama show "$1"
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# Show model information, JSON version
#
# Usage: ollamaShowJson "modelName"
# Output: json
# Returns: 0 on success, 1 on error
ollamaShowJson() {
  ollamaApiPost "/api/show" "{\"model\": \"$1\"}"
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# Ollama application version, cli version
#
# Usage: ollamaVersion
# Output: text
# Returns: 0 on success, 1 on error
ollamaVersion() {
  ollama --version
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

# Ollama application version, JSON version
#
# Usage: ollamaVersionJson
# Output: json
# Returns: 0 on success, 1 on error
ollamaVersionJson() {
  ollamaApiGet "/api/version"
  # TODO - check response for error/success
  return $RETURN_SUCCESS
}

Model	Response words	Response bytes	Total duration	Load duration	Prompt eval count	Prompt eval duration	Prompt eval rate	Eval count	Eval duration	Eval rate	Model params	Model size	Model context	Ollama context	Ollama proc
deepseek-r1:14b	597	4243	6m15.6504715s	2.7879425s	1783 token(s)	4.0784418s	437.18 tokens/s	2349 token(s)	6m8.7834033s	6.37 tokens/s	14.8B	14 GB	131072	16384	48%/52% CPU/GPU
deepseek-r1:8b	647	4699	14m21.2021266s	3.2627999s	1782 token(s)	1.7477969s	1019.57 tokens/s	9534 token(s)	14m16.1910182s	11.14 tokens/s	8.2B	9.6 GB	131072	16384	23%/77% CPU/GPU
dolphin3:8b	432	2887	30.6933286s	3.0549306s	1797 token(s)	1.4746932s	1218.56 tokens/s	549 token(s)	26.1626261s	20.98 tokens/s	8.0B	8.7 GB	131072	16384	15%/85% CPU/GPU
gemma3n:e4b	981	7030	1m51.3876623s	4.2704795s	2235 token(s)	8.1724663s	273.48 tokens/s	1870 token(s)	1m38.9431165s	18.90 tokens/s	6.9B	8.5 GB	32768	16384	12%/88% CPU/GPU
mistral:7b	486	3153	33.0599898s	2.6213209s	2065 token(s)	1.8082413s	1141.99 tokens/s	703 token(s)	28.629913s	24.55 tokens/s	7.2B	8.3 GB	32768	16384	11%/89% CPU/GPU
qwen2.5vl:7b	1534	10222	1m50.4283671s	2.7010685s	1800 token(s)	1.1966003s	1504.26 tokens/s	2780 token(s)	1m46.5294661s	26.10 tokens/s	8.3B	10 GB	128000	16384	34%/66% CPU/GPU
qwen3:8b	841	6411	4m21.8895935s	3.2772767s	1790 token(s)	1.7939954s	997.77 tokens/s	3154 token(s)	4m16.8178007s	12.28 tokens/s	8.2B	9.6 GB	40960	16384	23%/77% CPU/GPU

System
Ollama proc	23%/77% CPU/GPU
Ollama context	16384
Ollama version	0.10.0-rc0
Multirun timeout	99999 seconds
Sys arch	x86_64
Sys processor	unknown
sys memory	14G + 16G
Sys OS	CYGWIN_NT-10.0-22631 3.6.4-1.x86_64