Class OllamaAiProviderPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

uno.anahata.asi.swing.components.ScrollablePanel

uno.anahata.asi.swing.AbstractAiProviderPanel<OllamaAiProvider>

uno.anahata.asi.swing.provider.OpenAiChatCompletionsProviderPanel<OllamaAiProvider>

uno.anahata.asi.swing.provider.OllamaAiProviderPanel

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, Scrollable

public class OllamaAiProviderPanel
extends OpenAiChatCompletionsProviderPanel<OllamaAiProvider>

Specialized Swing configuration panel for Ollama AI providers.

In addition to standard OpenAI-compatible base URL and custom headers, this panel exposes Ollama-native diagnostics including server version detection, an active GPU VRAM and loaded model monitor (/api/ps), and on-demand VRAM unloading (keep_alive: 0).

Author:

anahata

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
private JButton	pullModelBtn	Button to download and install a new model from ollama.com or custom tag.
private JProgressBar	pullProgressBar	Progress bar displaying download percentage and bytes.
private JPanel	pullProgressPanel	Visual container for in-flight model download progress.
private JLabel	pullStatusLabel	Label showing the status text of the active model pull.
private JButton	refreshRunningBtn	Button to refresh the active VRAM / running models list.
private JTable	runningModelsTable	Table displaying models currently loaded in host memory and GPU VRAM.
private DefaultTableModel	runningModelsTableModel	Data model backing the running models table.
private JButton	unloadModelBtn	Button to unload the selected model from GPU memory.
private JLabel	versionLabel	Label displaying the detected Ollama server version.
private JLabel	vramStatusLabel	Label displaying active models count in memory or idle notice.

Fields inherited from class AbstractAiProviderPanel

acquisitionLinkLabel, apiKeyRequiredCheck, autoRegisterCheck, baseUrlField, classField, container, currentApiKeysPath, descriptionField, displayNameField, enabledCheck, folderLabel, folderRow, formPanel, headerLeft, keyPoolLabel, keysContainer, keysFileLabel, promoBannerContainer, provider, registryViewer, removeCallback, testConnectionBtn, textArea, tokenizerCombo, uuidLabel

Modifier and Type	Field	Description
protected JLabel	acquisitionLinkLabel	Link to the API key acquisition page.
protected JCheckBox	apiKeyRequiredCheck	Determines if the key pool must be populated for this provider to function.
protected JCheckBox	autoRegisterCheck	Checkbox to toggle automatically registering newly discovered models.
protected JTextField	baseUrlField	The endpoint root for Chat Completion API calls.
protected JTextField	classField	Readonly field displaying the concrete provider class FQN.
protected AbstractSwingAsiContainer	container	The parent ASI container instance.
protected String	currentApiKeysPath	The pending custom API keys file path selected by the user.
protected JTextField	descriptionField	Editable description for this provider instance.
protected JTextField	displayNameField	User-facing name for this provider instance.
protected JCheckBox	enabledCheck	Master switch to enable/disable the provider globally.
protected JLabel	folderLabel	Visual indicator of where this provider's data is stored on the host FS.
protected JPanel	folderRow	Row panel containing the keys file path label and choose/open buttons.
protected JPanel	formPanel	The main scrollable form panel container.
protected JPanel	headerLeft	Visual container for provider logo icon in the top header row.
protected JLabel	keyPoolLabel	Label for the API Key Pool section.
protected JPanel	keysContainer	Container panel for the API key pool text area.
protected JLabel	keysFileLabel	Label for the API Keys File row.
protected JPanel	promoBannerContainer	Visual container hosting promo banner, dynamically updated per provider.
protected OllamaAiProvider	provider	The domain entity representing the AI provider being configured.
protected AiModelsPanel	registryViewer	Embedded models explorer panel.
protected Runnable	removeCallback	The callback invoked when the user requests provider deletion.
protected JButton	testConnectionBtn	Triggers an immediate model discovery probe to verify the URL and Auth.
protected JTextArea	textArea	Monospace editor for the 'api_keys.txt' file, supporting multiple keys.
protected JComboBox<TokenizerType>	tokenizerCombo	Selector for the tokenizer used for pre-flight metabolic estimations.
protected JLabel	uuidLabel	Readonly label displaying the active provider UUID.

Fields inherited from class JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
OllamaAiProviderPanel()	Constructs a new uninitialized OllamaAiProviderPanel.

Method Summary

Modifier and Type	Method	Description
private void	checkServerVersion()	Checks the running Ollama server version via OllamaAiProvider.getServerVersion() in a background task.
private void	executePull(String modelTag)	Initiates the asynchronous model pull and binds live progress to pullProgressBar.
private static String	formatBytes(long bytes)	Formats bytes into human-readable representation using commons-io.
private static String	formatExpiry(String expiresAt)	Formats an ISO expiration timestamp into relative remaining time.
void	init(@NonNull AbstractSwingAsiContainer container, @NonNull OllamaAiProvider provider, Runnable removeCallback)	Initializes all UI components, listeners, and models table bound to the specified provider.
private boolean	isModelInstalled(String modelTag)	Checks if a model tag is already installed on the Ollama server by comparing against live discovered models from /api/tags and registered local models.
private void	openPullDialog(List<OllamaRemoteModel> remoteModels)	Constructs and opens the model pull dialog with an alphabetically sorted list showing model sizes, release dates, and installed status from the live server.
private void	refreshRunningModels()	Refreshes the running models loaded in memory via OllamaAiProvider.getRunningModels() in a background task.
private void	showPullModelDialog()	Queries ollama.com tags and displays the model pulling dialog with autocompletion.
private void	unloadSelectedModel()	Unloads the selected model from memory by sending keep_alive: 0.

Methods inherited from class OpenAiChatCompletionsProviderPanel

isModified, syncToProvider

Modifier and Type	Method	Description
boolean	isModified()	Checks if any settings or API key text in the UI have been modified compared to the domain entity.
void	syncToProvider()	Synchronizes the UI state back to the provider domain and flushes the key pool to disk.

Methods inherited from class AbstractAiProviderPanel

loadKeys, setProvider, updateHeaderIcon, updateKeySectionVisibility, updatePromoBanner

Modifier and Type	Method	Description
protected void	loadKeys()	Loads the raw key pool text.
void	setProvider(OllamaAiProvider newProvider)	Re-binds this panel to a different provider instance dynamically.
protected void	updateHeaderIcon()	Updates the provider icon in the top-left header.
protected void	updateKeySectionVisibility()	Toggles visibility of the key pool and keys file rows based on whether an API key is required.
protected void	updatePromoBanner()	Updates the promo banner in the promo container based on active provider.

Methods inherited from class ScrollablePanel

getPreferredScrollableViewportSize, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, setScrollableTracksViewportHeight, setScrollableTracksViewportWidth

Modifier and Type	Method	Description
Dimension	getPreferredScrollableViewportSize()
int	getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
boolean	getScrollableTracksViewportHeight()
boolean	getScrollableTracksViewportWidth()
int	getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
void	setScrollableTracksViewportHeight(boolean scrollableTracksViewportHeight)	Sets whether this panel should track the viewport's height.
void	setScrollableTracksViewportWidth(boolean scrollableTracksViewportWidth)	Sets whether this panel should track the viewport's width.

Methods inherited from class JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

versionLabel

private JLabel versionLabel

Label displaying the detected Ollama server version.

vramStatusLabel

private JLabel vramStatusLabel

Label displaying active models count in memory or idle notice.

runningModelsTable

private JTable runningModelsTable

Table displaying models currently loaded in host memory and GPU VRAM.

runningModelsTableModel

private DefaultTableModel runningModelsTableModel

Data model backing the running models table.

refreshRunningBtn

private JButton refreshRunningBtn

Button to refresh the active VRAM / running models list.

unloadModelBtn

private JButton unloadModelBtn

Button to unload the selected model from GPU memory.

pullModelBtn

private JButton pullModelBtn

Button to download and install a new model from ollama.com or custom tag.

pullProgressPanel

private JPanel pullProgressPanel

Visual container for in-flight model download progress.

pullStatusLabel

private JLabel pullStatusLabel

Label showing the status text of the active model pull.

pullProgressBar

private JProgressBar pullProgressBar

Progress bar displaying download percentage and bytes.

Constructor Details

OllamaAiProviderPanel

public OllamaAiProviderPanel()

Constructs a new uninitialized OllamaAiProviderPanel.

Method Details

init

public void init(@NonNull
 @NonNull AbstractSwingAsiContainer container,
 @NonNull
 @NonNull OllamaAiProvider provider,
 Runnable removeCallback)

Initializes all UI components, listeners, and models table bound to the specified provider.

Adds custom headers multi-line editor and prefer HTTP/1.1 checkbox.

Enhances the panel with Ollama server version diagnostics and a live VRAM process monitor.

Overrides:

init in class OpenAiChatCompletionsProviderPanel<OllamaAiProvider>

Parameters:

container - The parent ASI container instance.

provider - The provider instance to bind to.

removeCallback - Callback to trigger when the user deletes the provider.

checkServerVersion

private void checkServerVersion()

Checks the running Ollama server version via OllamaAiProvider.getServerVersion() in a background task.

refreshRunningModels

private void refreshRunningModels()

Refreshes the running models loaded in memory via OllamaAiProvider.getRunningModels() in a background task.

unloadSelectedModel

private void unloadSelectedModel()

Unloads the selected model from memory by sending keep_alive: 0.

showPullModelDialog

private void showPullModelDialog()

Queries ollama.com tags and displays the model pulling dialog with autocompletion.

openPullDialog

private void openPullDialog(List<OllamaRemoteModel> remoteModels)

Constructs and opens the model pull dialog with an alphabetically sorted list showing model sizes, release dates, and installed status from the live server.

Parameters:

remoteModels - the list of remote models fetched from ollama.com

isModelInstalled

private boolean isModelInstalled(String modelTag)

Checks if a model tag is already installed on the Ollama server by comparing against live discovered models from /api/tags and registered local models.

Parameters:

modelTag - the model tag to check

Returns:

true if installed on the server

executePull

private void executePull(String modelTag)

Initiates the asynchronous model pull and binds live progress to pullProgressBar.

Parameters:

modelTag - the model name and tag to pull

formatBytes

private static String formatBytes(long bytes)

Formats bytes into human-readable representation using commons-io.

Parameters:

bytes - the raw byte count

Returns:

formatted string

formatExpiry

private static String formatExpiry(String expiresAt)

Formats an ISO expiration timestamp into relative remaining time.

Parameters:

expiresAt - the ISO timestamp

Returns:

formatted relative string