open-terminalui

open-terminalui is a modern terminal-based user interface for interacting with local LLMs powered by Ollama. It provides an intuitive chat interface with document management, vector search capabilities, and a clean, responsive design built with Textual.

Table of Contents

• Installation
  • Prerequisites
• Development
• License

Installation

Prerequisites

open-terminalui requires Ollama to run local LLMs. Follow these steps to set up your environment:

1. Install Ollama

Visit https://ollama.ai and download Ollama for your operating system, or use the following commands:

macOS:

brew install ollama

Linux:

curl -fsSL https://ollama.ai/install.sh | sh

Windows: Download the installer from https://ollama.ai/download

2. Pull the Llama 3.2 Model

After installing Ollama, pull the llama3.2 model:

ollama pull llama3.2

3. Start Ollama

Start the Ollama service:

ollama serve

Note: On macOS and Windows, Ollama typically starts automatically. On Linux, you may need to run this command or set it up as a service.

4. Install open-terminalui

Install open-terminalui using pipx:

pipx install open-terminalui

If you don't have pipx installed, you can install it with:

# macOS
brew install pipx
pipx ensurepath

# Linux
python3 -m pip install --user pipx
python3 -m pipx ensurepath

# Windows
python -m pip install --user pipx
python -m pipx ensurepath

5. Run open-terminalui

Launch the application:

open-terminalui

The terminal UI will start and connect to your local Ollama instance running llama3.2.

Development

Installation

uv sync

Testing

textual run --dev open_terminalui.entry_points:app

In a seperate console

textual console  # All logs
textual console -x SYSTEM -x EVENT -x DEBUG -x INFO # Minimal logs

License

open-terminalui is distributed under the terms of the MIT license.