oterm  by ggozad

Terminal client for Ollama

created 1 year ago
2,094 stars

Top 21.9% on sourcepulse

GitHubView on GitHub
Project Summary

oterm is a terminal-based client for Ollama, designed for users who want a direct, serverless interface to interact with local large language models. It provides a persistent, customizable chat experience within the terminal, supporting features like multiple sessions, system prompt and parameter customization, and integration with external tools via the Model Context Protocol (MCP).

How It Works

oterm leverages a direct connection to Ollama, eliminating the need for separate server or frontend processes. It stores chat sessions, system prompts, and parameter customizations in an SQLite database for persistence. The client supports the Model Context Protocol (MCP) for tool integration, allowing users to create custom commands and provide external information to LLMs directly from the terminal. It also features sixel graphics support for in-terminal image display.

Quick Start & Requirements

  • Install via uvx oterm (see Installation).
  • Requires Ollama to be installed and running.
  • Supports Linux, macOS, and Windows.

Highlighted Details

  • Supports Model Context Protocol (MCP) for tools and prompts integration.
  • Features sixel graphics for in-terminal image display.
  • Allows customization of system prompts, parameters, and multiple themes.
  • Persistent chat sessions stored in SQLite.

Maintenance & Community

The project is actively maintained by ggozad. Further community engagement details are not specified in the README.

Licensing & Compatibility

Licensed under the MIT License. This license is permissive and generally compatible with commercial and closed-source applications.

Limitations & Caveats

oterm relies on Ollama being installed and accessible. While it supports multiple platforms, specific terminal emulator compatibility may vary, especially for advanced features like sixel graphics.

Health Check
Last commit

1 month ago

Responsiveness

1 day

Pull Requests (30d)
0
Issues (30d)
3
Star History
350 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.