LazyOllama

A minimal terminal UI for managing Ollama models, inspired by lazydocker and lazygit.

What it does

LazyOllama provides a simple, keyboard-driven interface for:

• Viewing all your Ollama models with real-time status (running/stopped)
• Starting interactive chats with any model
• Stopping running models to free up resources
• Refreshing the model list to see newly pulled models

The interface automatically returns you back after chatting, making it easy to switch between different models.

Features

• 🎯 Ultra-simple interface - Single panel showing models with status indicators
• ⚡ Direct chat execution - Press Enter to launch interactive ollama run <model>
• 🛑 Model control - Stop running models with x key
• 📊 Real-time status - See which models are running (●) or stopped (○)
• ⌨️ Vim-like navigation - Navigate with j/k keys
• 🔄 Seamless workflow - Returns to interface after chat sessions
• 🖥️ Cross-platform - Works on Linux, macOS, and other Unix-like systems

Dependencies

• Ollama - Must be installed and running
• Go 1.21+ - Required for compilation
• Terminal - Any terminal emulator with basic TUI support

Installation

Prerequisites

1. Install Ollama from ollama.ai
2. Install Go (1.21 or later) from golang.org

Compilation

# Clone or download the source
git clone <repository-url>
cd lazyollama

# Compile the binary
go mod tidy
go build -o lazyollama lazyollama.go

Installation by OS

Debian/Ubuntu

# System-wide installation (recommended)
sudo cp lazyollama /usr/local/bin/

# User-only installation
mkdir -p ~/.local/bin
cp lazyollama ~/.local/bin/
# Add ~/.local/bin to PATH if not already there:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Arch Linux

# System-wide installation (recommended)
sudo cp lazyollama /usr/local/bin/

# Or install to user bin
mkdir -p ~/bin
cp lazyollama ~/bin/
# Add ~/bin to PATH if needed:
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

macOS

# System-wide installation (recommended)
sudo cp lazyollama /usr/local/bin/

# User-only installation with Homebrew path structure
mkdir -p ~/.local/bin
cp lazyollama ~/.local/bin/
# Add to PATH:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Other Unix-like Systems

# System-wide (requires sudo)
sudo cp lazyollama /usr/local/bin/

# User-only
mkdir -p ~/.local/bin
cp lazyollama ~/.local/bin/
export PATH="$HOME/.local/bin:$PATH"

Verification

After installation, verify it works:

lazyollama

Usage

Launch the application:

lazyollama

Interface:

Controls:

• j/k - Navigate up/down through models
• Enter - Start interactive chat with selected model
• x - Stop running model (only shown when model is running)
• r - Refresh model list
• q or Ctrl+C - Quit application

Workflow:

1. Navigate to desired model with j/k
2. Press Enter to start chatting
3. Chat normally with the model
4. Exit chat (usually Ctrl+D or /bye)
5. LazyOllama interface automatically returns
6. Repeat with any other model

Troubleshooting

"command not found" error:

• Ensure the binary is in a directory that's in your PATH
• Try running with full path: /usr/local/bin/lazyollama

"ollama not found" error:

• Install Ollama from ollama.ai
• Ensure ollama is running: ollama serve

Terminal display issues:

• Ensure you're running in a proper terminal emulator
• Try resizing your terminal window

License

MIT License