Skip to main content

A text-based terminal client for Ollama.

Project description

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 the context embeddings and template/system prompt 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 template, system prompt and parameters.

Installation

Using brew for MacOS:

brew tap ggozad/formulas
brew install ggozad/formulas/oterm

Using pip:

pip install oterm

Using

In order to use oterm you will need to have the Ollama server running. By default it expects to find the Ollama API running on http://localhost:11434/api. If you are running Ollama inside docker or on a different host/port, use the OLLAMA_URL environment variable to customize the API url.

OLLAMA_URL=http://host:port/api

oterm will not (yet) pull models for you, please use ollama to do that. All the models you have pulled or created will be available to oterm.

Customizing models

When creating a new chat, you may not only select the model, but also customize the template as well as the system instruction to pass to the model.

Screenshots

Chat Model selection

License

This project is licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

oterm-0.1.9.tar.gz (13.5 kB view details)

Uploaded Source

Built Distribution

oterm-0.1.9-py3-none-any.whl (16.8 kB view details)

Uploaded Python 3

File details

Details for the file oterm-0.1.9.tar.gz.

File metadata

  • Download URL: oterm-0.1.9.tar.gz
  • Upload date:
  • Size: 13.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.11.6 Darwin/23.0.0

File hashes

Hashes for oterm-0.1.9.tar.gz
Algorithm Hash digest
SHA256 17c0d15e3d460f774753590e002c83101cc011b3d0108e6626a78aa010358b31
MD5 1c5f414a90da2c725c86f7ce80578aa5
BLAKE2b-256 40fa1eda5473399a0614c04cd6ede2a99873e292f097ac37f9c222fa39d51132

See more details on using hashes here.

File details

Details for the file oterm-0.1.9-py3-none-any.whl.

File metadata

  • Download URL: oterm-0.1.9-py3-none-any.whl
  • Upload date:
  • Size: 16.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.11.6 Darwin/23.0.0

File hashes

Hashes for oterm-0.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 e44d50fe88a699e67a6590b9f6307e158f0b508721e7d4d4d1a142fc86f9a9da
MD5 b5c927af0dc3ba4f56a505f8a0e8b796
BLAKE2b-256 afecf509f733fb487672e198858e9a15240793f0578f49d1a94f3eca231ccfae

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page