the terminal client for LLMs
  • Python 99.7%
  • HTML 0.3%
Find a file
Yiorgis Gozadinos affb23dde7 vb
2025-03-15 23:50:26 +01:00
.github Github action workflow, colorize code blocks 2025-02-24 21:58:46 +01:00
docs Command documentation 2025-02-25 20:12:16 +01:00
src/oterm Include the default environment when running an mcp server with custom env. 2025-03-15 23:45:19 +01:00
tests Fix mcp tool test 2025-03-15 10:39:53 +01:00
.gitignore Github action workflow, colorize code blocks 2025-02-24 21:58:46 +01:00
CHANGES.txt vb 2025-03-15 23:50:26 +01:00
LICENSE Readme, license 2023-10-15 19:53:05 +02:00
mkdocs.yml Command documentation 2025-02-25 20:12:16 +01:00
pyproject.toml vb 2025-03-15 23:50:26 +01:00
README.md Command documentation 2025-02-25 20:12:16 +01:00
uv.lock vb 2025-03-15 23:50:26 +01: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.
  • 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

  • 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.
  • Support for Model Context Protocol (MCP) tools. You can now use any of the MCP tools to provide external information to the model.
  • Support for the <thinking/> tag in reasoning models.

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.