the terminal client for LLMs
  • Python 99.7%
  • HTML 0.3%
Find a file
Yiorgis Gozadinos b692f684bb
vb
2025-05-21 18:42:36 +02:00
.github enhancement not feature request 2025-04-27 09:43:23 +02:00
docs Update screensots 2025-05-11 08:51:42 +02:00
src/oterm Update prompt calling for mcp@1.9.0. Closes #240 2025-05-21 18:38:53 +02:00
tests Fix date_time tool test 2025-05-10 17:41:13 +02:00
.gitignore Update .gitignore 2025-04-26 18:48:33 +02:00
.pre-commit-config.yaml Remove oterm-command 2025-05-11 08:40:57 +02:00
CHANGES.txt vb 2025-05-21 18:42:36 +02:00
LICENSE Fix linter errors 2025-04-06 10:49:33 +03:00
mkdocs.yml Remove oterm-command 2025-05-11 08:40:57 +02:00
pyproject.toml vb 2025-05-21 18:42:36 +02:00
README.md Update screensots 2025-05-11 08:51:42 +02:00
uv.lock vb 2025-05-21 18:42:36 +02:00

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

  • Messages UI styling improvements.
  • MCP Sampling is here! Also support for SSE & WebSocket transports for MCP servers.
  • 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!

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.