ollama-chat 0.9.31

An Ollama chat web application

ollama-chat

Ollama Chat is a web chat client for Ollama that allows you to chat locally (and privately) with Large Language Models (LLMs).

Features

• Platform independent - tested on macOS, Windows, and Linux
• Chat with any local Ollama model
• Save conversations for later viewing and interaction
• Single and multiline prompts
• Regenerate the most recent conversation response
• Delete the most recent conversation exchange
• View responses as Markdown or text
• Save conversations as Markdown text
• Multiple concurrent chats
• Prompt commands for including file and URL content
• Conversation templates for repeating prompts with variable substitutions

Installation

To get up and running with Ollama Chat follows these steps:

1. Install and start Ollama

2. Install Ollama Chat

   pip install ollama-chat
   

Updating

To update Ollama Chat:

pip install -U ollama-chat

Start Ollama Chat

To start Ollama Chat, open a terminal prompt and run the Ollama Chat application:

ollama-chat

A web browser is launched and opens the Ollama Chat web application.

By default, a configuration file, "ollama-chat.json", is created in the user's home directory.

To start a conversation from the command line, use the -m argument:

ollama-chat -m "Why is the sky blue?"

Prompt Commands

Ollama Chat supports special prompt commands that allow you to include file and URL content in your prompt, among other things. The following prompt commands are available:

• /file - include a file

  /file README.md
  
  Please summarize the README file.
  

• /dir - include files from a directory

  /dir src/ollama_chat py
  
  Please provide a summary for each Ollama Chat source file.
  

• /url - include a URL resource

  /url https://craigahobbs.github.io/ollama-chat/README.md
  
  Please summarize the README file.
  

• /do - execute a conversation template by name or title

  /do city-report -v CityState "Seattle, WA"
  

To get prompt command help use the -h option:

/file -h

Conversation Templates

Conversation Templates allow you to repeat the same prompts with different models. Templates can define variables that may be included in the template title and prompt text ({{var}}). For example:

{
    "conversations": [],
    "templates": [
        {
            "title": "City Report for {{CityState}}",
            "prompts": [
                "Tell me about {{CityState}}",
                "What is the average cost of living in {{CityState}}?"
            ],
            "variables": [
                {
                    "label": "City, State",
                    "name": "CityState"
                }
            ]
        }
    ]
}

File Format and API Documentation

Ollama Chat File Format

Ollama Chat API

Development

This package is developed using python-build. It was started using python-template as follows:

template-specialize python-template/template/ ollama-chat/ -k package ollama-chat -k name 'Craig A. Hobbs' -k email '[e-mail]' -k github 'craigahobbs' -k noapi 1