ollama-utility

Forked from ollama-ui

A simple HTML UI for Ollama

Chat	Notepad	Function Calling

Setup/Usage

Mac/Linux (With Git)

git clone https://github.com/ismaelc/ollama-utility
cd ollama-utility
make
(open http://localhost:8000) # Open in browser

Mac/Linux (Without Git)

Download and extract the utility directly:

curl -L https://github.com/ismaelc/ollama-utility/archive/main.zip -o ollama-utility.zip
unzip ollama-utility.zip
cd ollama-utility-main
make
(open http://localhost:8000) # Open in browser

Or, if curl is not available, use wget:

wget https://github.com/ismaelc/ollama-utility/archive/main.zip -O ollama-utility.zip
unzip ollama-utility.zip
cd ollama-utility-main
make
(open http://localhost:8000) # Open in browser

Windows

Download the Ollama Windows client from https://ollama.com/download/windows

Open PowerShell as Administrator and run:

# Download and run GetOllamaUtility.ps1. This will create an `ollama-utility` folder in the current directory
Invoke-WebRequest "https://raw.githubusercontent.com/ismaelc/ollama-utility/main/windows/GetOllamaUtility.ps1" -OutFile "GetOllamaUtility.ps1"
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
.\GetOllamaUtility.ps1

# Download and run RunOllamaUtility.ps1. Run the ps1 file below just outside of the `ollama-utility` folder.
Invoke-WebRequest "https://raw.githubusercontent.com/ismaelc/ollama-utility/main/windows/RunOllamaUtility.ps1" -OutFile "RunOllamaUtility.ps1"
.\RunOllamaUtility.ps1

# Open in browser
(open http://localhost:8000)

If a message indicates you need Python, simply type "Python" in the same Terminal to open up Microsoft Store to download/install Python.

Maintenance Commands

Update to latest version:

git pull origin main

...or, if Git is not installed, re-download the latest version as described above.

Get new models:

Go to https://ollama.com/library and click on a model. Click Tags

ollama pull gemma:7b-instruct-q4_K_M

...refresh http://localhost:8000 to update the model dropdown selection

Terminate running ollama service:

pkill -f "ollama serve"

Free up port 8000:

lsof -ti:8000 | xargs kill

...or in Powershell...

Get-NetTCPConnection | Where-Object { $_.LocalPort -eq 8000 } | Select-Object -ExpandProperty OwningProcess | ForEach-Object { Stop-Process -Id $_ -Force }

Function Calling

Function calling enables Language Model (LLM) users to invoke function identifiers. In this project, the function calling mechanism is basic and primarily intended for assessing a model's function capability.

To experiment with this feature, import some examples from the sample_sessions folder.

You can develop your custom Tools by placing them in the tools folder and referencing them in the system prompt. The example sessions labeled "Function" serve as templates for these system prompts.