oterm

by ggozad

MCP Client 1,919 stars
  • other

the terminal client for Ollama

About

What is oterm?

oterm is a terminal client for Ollama that lets you chat with local AI models directly from your terminal. It runs on Linux, macOS, and Windows and provides a simple, intuitive UI with no need to run separate servers or front‑ends.

How to use oterm?

Open your terminal and run uvx oterm to launch the application. Detailed installation options are available in the oterm documentation.

Key features of oterm

- Start chatting instantly with oterm in any terminal.
- Supports Linux, macOS, and Windows.
- Multiple persistent chat sessions with custom system prompts and parameters, stored in SQLite.
- Full Model Context Protocol (MCP) integration – tools, prompts, and sampling.
- Works with any Ollama model, including custom models.
- Easy customization of system prompt and model parameters.

Use cases of oterm

- Chat with local LLMs entirely from the command line without additional servers.
- Use MCP tools (e.g., a git MCP server) to provide external context to the model.
- Run multiple parallel conversations, each with its own system prompt and model settings.
- Switch between different Ollama models on the fly and fine‑tune their parameters.

FAQ from oterm

How do I install oterm?

Run uvx oterm in your terminal. More installation methods are covered in the documentation.

What platforms are supported?

oterm runs on Linux, macOS, and Windows and works with most terminal emulators.

Which models can oterm use?

oterm can use any model you have pulled in Ollama, including custom models.

Does oterm support MCP?

Yes, oterm supports Model Context Protocol (MCP) tools, prompts, and sampling, along with SSE and WebSocket transports for MCP servers.

What license does oterm use?

oterm is open‑source under the MIT License.

Details

Author
ggozad
GitHub stars
1,919
Category
other
Repository
ggozad/oterm

oterm

the terminal client for Ollama.

Features

intuitive and simple terminal UI, no need to run servers, frontends, just type oterm in your terminal.
supports Linux, MacOS, and Windows and most terminal emulators.
multiple persistent chat sessions, stored together with system prompt & parameter customizations in sqlite.
support for Model Context Protocol (MCP) tools & prompts integration.
can use any of the models you have pulled in Ollama, or your own custom models.
allows for easy customization of the model's system prompt and parameters.
supports tools integration for providing external information to the model.

Quick install

uvx oterm
See Installation for more details.

Documentation

oterm Documentation

What's new

Support for "thinking" mode for models that support it. Support for streaming with tools! Messages UI styling improvements.
  • MCP Sampling is here in addition to MCP tools & prompts! Also support for SSE & WebSocket transports for MCP servers.

Screenshots

Splash The splash screen animation that greets users when they start oterm.

Chat
A view of the chat interface, showcasing the conversation between the user and the model.

Model selection
The model selection screen, allowing users to choose and customize available models.

Tool support
oterm using the git MCP server to access its own repo.

Image selection
The image selection interface, demonstrating how users can include images in their conversations.

Theme
oterm supports multiple themes, allowing users to customize the appearance of the interface.

License

This project is licensed under the MIT License.