the terminal client for LLMs
  • Python 99.7%
  • HTML 0.3%
Find a file
Yiorgis Gozadinos 63a03a5ffc
Merge pull request #238 from ggozad/feat/streaming-with-tools
Implement streaming with tool support.
2025-05-30 15:53:27 +02:00
.github enhancement not feature request 2025-04-27 09:43:23 +02:00
docs Added x install Support for oterm 2025-05-13 11:09:24 +08:00
src/oterm Fix streaming after tool call 2025-05-30 15:49:31 +02:00
tests Implement streaming with tool support. 2025-05-30 15:49:31 +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-30 15:52:16 +02:00
README.md vb 2025-05-30 15:52:16 +02:00
uv.lock vb 2025-05-30 15:52:16 +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

  • 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.