the terminal client for LLMs
  • Python 99.7%
  • HTML 0.3%
Find a file
Yiorgis Gozadinos 7edc566fd0
vb
2025-04-13 22:00:37 +02:00
.github Fix linter errors 2025-04-06 10:49:33 +03:00
docs Document sampling 2025-04-13 21:55:50 +02:00
src/oterm Perform fuzzy search on model hints, pass temperature and stop words if present 2025-04-13 21:03:42 +02:00
tests Perform fuzzy search on model hints, pass temperature and stop words if present 2025-04-13 21:03:42 +02:00
.gitignore Fix linter errors 2025-04-06 10:49:33 +03:00
.pre-commit-config.yaml Add pre-commit hook for mkdocs 2025-04-13 15:47:07 +02:00
CHANGES.txt vb 2025-04-13 22:00:37 +02:00
LICENSE Fix linter errors 2025-04-06 10:49:33 +03:00
mkdocs.yml Development & debug docs 2025-04-12 14:51:01 +02:00
pyproject.toml vb 2025-04-13 22:00:37 +02:00
README.md vb 2025-04-13 22:00:37 +02:00
uv.lock vb 2025-04-13 22:00:37 +02:00

oterm

the text-based terminal client for 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

uvx oterm

See Installation for more details.

Documentation

oterm Documentation

What's new

  • MCP Sampling is here!
  • In-app log viewer for debugging and troubleshooting.
  • 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 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.