https://github.com/ggozad/oterm

a text-based terminal client for Ollama
https://github.com/ggozad/oterm

llm llms machine-learning ollama python terminal

Last synced: 12 days ago
JSON representation

a text-based terminal client for Ollama

• Host: GitHub
• URL: https://github.com/ggozad/oterm
• Owner: ggozad
• License: mit
• Created: 2023-10-10T07:29:26.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-04-10T11:00:54.000Z (12 days ago)
• Last Synced: 2025-04-10T12:46:01.049Z (12 days ago)
• Topics: llm, llms, machine-learning, ollama, python, terminal
• Language: Python
• Homepage:
• Size: 19.5 MB
• Stars: 1,565
• Watchers: 15
• Forks: 93
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.txt
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-repositories - ggozad/oterm - a text-based terminal client for Ollama (Python)
• Awesome-Local-LLM - _Git_
• Awesome-Local-LLM - _Git_
• awesome-local-llms - oterm - based terminal client for Ollama | 1,220 | 74 | 7 | 15 | 44 | MIT License | 5 days, 14 hrs, 6 mins | (Open-Source Local LLM Projects)

README

        
# oterm

the text-based terminal client for [Ollama](https://github.com/ollama/ollama).

## Features

* intuitive and simple terminal UI, no need to run servers, frontends, just type `oterm` in your terminal.

* 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

```bash

uvx oterm

```

See [Installation](https://ggozad.github.io/oterm/installation) for more details.

## Documentation

[oterm Documentation](https://ggozad.github.io/oterm/)

## What's new

* Support sixel graphics for displaying images in the terminal.

* Support for Model Context Protocol (MCP) tools & prompts!

* Create custom commands that can be run from the terminal using oterm. Each of these commands is a chat, customized to your liking and connected to the tools of your choice.

### Screenshots

![Splash](https://raw.githubusercontent.com/ggozad/oterm/refs/heads/main/docs/img/splash.gif)

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

![Chat](https://raw.githubusercontent.com/ggozad/oterm/main/docs/img/chat.png)

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

![Model selection](https://raw.githubusercontent.com/ggozad/oterm/main/docs/img/customizations.svg)

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

![Tool support](https://raw.githubusercontent.com/ggozad/oterm/main/docs/img/mcp_tools.svg)

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

![Image selection](https://raw.githubusercontent.com/ggozad/oterm/main/docs/img/image_selection.png)

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

![Theme](https://raw.githubusercontent.com/ggozad/oterm/main/docs/img/theme.svg)

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

## License

This project is licensed under the [MIT License](LICENSE).