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. Setting OTERM_VERIFY_SSL to False will disable SSL verification.

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. Checking the JSON output checkbox will cause the model reply in JSON format.

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.15.tar.gz (14.6 kB view details)

Uploaded Source

Built Distribution

oterm-0.1.15-py3-none-any.whl (18.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: oterm-0.1.15.tar.gz
  • Upload date:
  • Size: 14.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.11.6 Darwin/23.1.0

File hashes

Hashes for oterm-0.1.15.tar.gz
Algorithm Hash digest
SHA256 150aa6b226ac50f072be361094f18a2011f70b42653f0783c1b391a05da5d819
MD5 2e0a0cfbf1824557a9dbc53090c15e6f
BLAKE2b-256 b80bbd941f65140fb49bd67cf9b7de87d539ab98e0423c19ade160ed42bf1616

See more details on using hashes here.

File details

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

File metadata

  • Download URL: oterm-0.1.15-py3-none-any.whl
  • Upload date:
  • Size: 18.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.11.6 Darwin/23.1.0

File hashes

Hashes for oterm-0.1.15-py3-none-any.whl
Algorithm Hash digest
SHA256 6316c8a07a03e7ea4f9907d3055538c785e6b452ef7156d3d8c15a61747f0aa1
MD5 17c461cb8cd2e372da380f78ef542a61
BLAKE2b-256 6413bbc32ebe9cb0708c5bc91531b670d7c2d621231aaff3d8afc73d475eb58b

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