Skip to main content

ollama-chat

PyPI - Status PyPI GitHub PyPI - Python Version

Ollama Chat is a conversational AI chat client that uses Ollama to interact with local large language models (LLMs) entirely offline. Ideal for AI enthusiasts, developers, or anyone wanting private, offline LLM chats.

Features

  • Chat with local large language models (LLMs) entirely offline
  • Prompt Commands to include files, images, and URL content
  • Conversation Templates for repeating prompts with variable substitutions
  • Browse, download, monitor, and select local models directly in the app
  • Multiple concurrent chats
  • Show/hide thinking of reasoning models
  • Regenerate the most recent conversation response
  • Delete the most recent conversation exchange
  • View responses as Markdown or text
  • Read responses aloud with offline speech synthesis
  • Save conversations as Markdown text
  • Start a conversation or template from the command line
  • Platform independent - tested on macOS, Windows, and Linux

Installation

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

  1. Install Ollama

  2. Install Ollama Chat

    macOS and Linux

    python3 -m venv $HOME/venv --upgrade-deps
    . $HOME/venv/bin/activate
    pip install ollama-chat
    

    Windows

    python3 -m venv %USERPROFILE%\venv --upgrade-deps
    %USERPROFILE%\venv\Scripts\activate
    pip install ollama-chat
    

Start Ollama Chat

To start Ollama Chat, open a terminal prompt and follow the steps for your OS. When you start Ollama Chat, a web browser is launched and opens the Ollama Chat application.

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

macOS and Linux

. $HOME/venv/bin/activate
ollama-chat

Windows

%USERPROFILE%\venv\Scripts\activate
ollama-chat

Start a Conversation from the Command Line

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

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

Start a Template from the Command Line

To start a named template from the command line, use the -t and -v arguments:

ollama-chat -t askAristotle -v question "Why is the sky blue?"

Add a Desktop Launcher

To add a desktop launcher, follow the steps for your OS.

macOS

In Finder, locate the "ollama-chat" executable and drag-and-drop it into the lower portion of the Dock.

Windows

In File Explorer, locate the "ollama-chat" executable, right-click it, and select "Pin to Start".

GNOME (Linux)

  1. Copy the following Ollama Chat desktop file contents:

    [Desktop Entry]
    Name=Ollama Chat
    Exec=sh -c "$HOME/venv/bin/ollama-chat"
    Type=Application
    Icon=dialog-information
    Terminal=true
    Categories=Utility;
    
  2. Create the Ollama Chat desktop file and paste the contents:

    nano $HOME/.local/share/applications/ollama-chat.desktop
    
  3. Update the "Exec" path, if necessary, and save

Conversation Templates

Conversation Templates allow you to repeat a sequence of prompts. Templates can include variable substitutions in the title text and the prompt text (e.g., {{var}}).

Create a Template

There are two ways to create a template:

  • Click "Add Template" from the home page
  • Click "Template" on a conversation page

Run a Template

To run a template, click on its title on the home page. If the template has any variables, the user is prompted for their values prior to running the template. When a template runs, a new conversation is created and each prompt is entered in sequence.

Edit a Template

To edit a template, from the home page, click "Select" on the template you want to edit, and then click "Edit". On the template editor page you can update the template's title, set its name, add or remove variables, and add or remove prompts.

Prompt Commands

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

  • /file - include a file

    /file README.md
    
  • /image - include an image

    /image image.jpeg
    
  • /dir - include files from a directory

    /dir src/ollama_chat py
    
  • /url - include a URL resource

    /url https://craigahobbs.github.io/ollama-chat/README.md
    
  • /do - execute a conversation template by name

    /do city-report -v CityState "Seattle, WA"
    
  • /? - list available prompt commands

    /?
    

To get prompt command help use the -h option:

/file -h

Ollama Models

Browse the models available to download with Ollama

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 'craigahobbs@gmail.com' -k github 'craigahobbs' -k noapi 1

Metadata

Release files for ollama-chat 1.6.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ollama-chat 1.6.6
File Size Uploaded Provenance Actions
ollama_chat-1.6.6.tar.gz 1.0 MB Without provenance Details for ollama_chat-1.6.6.tar.gz

Release files / ollama_chat-1.6.6.tar.gz

Download URL ollama_chat-1.6.6.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
dd38214a836758335f0965b5cc6238c96b1dd37029f09c5c9a490eed0dcd68d8
BLAKE2b-256 checksum
How to use checksums
76d4f5c9a33e4e50bb7bde4343367920f5fdaa2bce9afa48d549f549f4982575
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.10

Security for ollama-chat 1.6.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.6.6 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page