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.

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

Uploaded Source

Built Distribution

oterm-0.1.10-py3-none-any.whl (17.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: oterm-0.1.10.tar.gz
  • Upload date:
  • Size: 13.8 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.10.tar.gz
Algorithm Hash digest
SHA256 c2342cac38eac1fb195af8ef2dfdf5e6fcb3eb9e4b2f2ae1267d87224c2805d6
MD5 cb973060398c03017d7f0c6d3f2f0db9
BLAKE2b-256 ceb9325628b5d8a5293a84065286258746b8504a9bbca200de4e73dea09d9b3c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: oterm-0.1.10-py3-none-any.whl
  • Upload date:
  • Size: 17.1 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.10-py3-none-any.whl
Algorithm Hash digest
SHA256 361d86c9047485b7f7ff1ae69d70ca729aa8fac621096f53439bef03a60f88a1
MD5 8dbe7f170463da2df40e9921c103d1a8
BLAKE2b-256 0b74cd96d7c1811b3cfb2f881156468fd55916bd993df764674ada06a76e9ea8

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