oterm  by ggozad

Terminal client for Ollama

Created 2 years ago
2,298 stars

Top 19.6% 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

3 weeks ago

Responsiveness

1 day

Pull Requests (30d)
1
Issues (30d)
1
Star History
20 stars in the last 30 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems") and Yaowei Zheng Yaowei Zheng(Author of LLaMA-Factory).

AstrBot by AstrBotDevs

1.1%
15k
LLM chatbot/framework for multiple platforms
Created 3 years ago
Updated 10 hours ago
Starred by Jasper Zhang Jasper Zhang(Cofounder of Hyperbolic), Addy Osmani Addy Osmani(Head of Chrome Developer Experience at Google), and
3 more.

chatbox by chatboxai

0.3%
38k
Desktop client app for AI models/LLMs
Created 2 years ago
Updated 1 day ago
Feedback? Help us improve.