ollama-chat 0.9.0__tar.gz

ollama_chat-0.9.0/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Craig A. Hobbs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ollama_chat-0.9.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.1
+Name: ollama-chat
+Version: 0.9.0
+Summary: ollama-chat
+Home-page: https://github.com/craigahobbs/ollama-chat
+Author: Craig A. Hobbs
+Author-email: craigahobbs@gmail.com
+License: MIT
+Keywords: ollama-chat
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: chisel>=1.2.7
+Requires-Dist: ollama>=0.1.9
+Requires-Dist: waitress>=3.0.0
+
+# ollama-chat
+
+[![PyPI - Status](https://img.shields.io/pypi/status/ollama-chat)](https://pypi.org/project/ollama-chat/)
+[![PyPI](https://img.shields.io/pypi/v/ollama-chat)](https://pypi.org/project/ollama-chat/)
+[![GitHub](https://img.shields.io/github/license/craigahobbs/ollama-chat)](https://github.com/craigahobbs/ollama-chat/blob/main/LICENSE)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ollama-chat)](https://pypi.org/project/ollama-chat/)
+
+**Ollama Chat** is a simple yet useful web chat client for
+[Ollama](https://ollama.com)
+that allows you to chat locally (and privately) with
+[open-source LLMs](https://ollama.com/library).
+
+
+# Installation
+
+To get up and running with Ollama Chat follows these steps:
+
+1. Install and start [Ollama](https://ollama.com)
+
+2. Install Ollama Chat
+
+   ~~~
+   pip install ollama-chat
+   ~~~
+
+
+# Starting 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 current directory to save
+your conversations.
+
+
+## Future Features
+
+In no particular order...
+
+- Save conversation as Markdown file
+
+- Conversation title edit
+
+- File / Directory / URL text inclusion in prompt
+
+- Local model management (pull, rm)
+  - [Models JSON](https://huggingface.co/api/models)
+
+- Prompt library
+
+
+## Development
+
+This package is developed using [python-build](https://github.com/craigahobbs/python-build#readme).
+It was started using [python-template](https://github.com/craigahobbs/python-template#readme) 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
+~~~

ollama_chat-0.9.0/README.md

@@ -0,0 +1,64 @@
+# ollama-chat
+
+[![PyPI - Status](https://img.shields.io/pypi/status/ollama-chat)](https://pypi.org/project/ollama-chat/)
+[![PyPI](https://img.shields.io/pypi/v/ollama-chat)](https://pypi.org/project/ollama-chat/)
+[![GitHub](https://img.shields.io/github/license/craigahobbs/ollama-chat)](https://github.com/craigahobbs/ollama-chat/blob/main/LICENSE)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ollama-chat)](https://pypi.org/project/ollama-chat/)
+
+**Ollama Chat** is a simple yet useful web chat client for
+[Ollama](https://ollama.com)
+that allows you to chat locally (and privately) with
+[open-source LLMs](https://ollama.com/library).
+
+
+# Installation
+
+To get up and running with Ollama Chat follows these steps:
+
+1. Install and start [Ollama](https://ollama.com)
+
+2. Install Ollama Chat
+
+   ~~~
+   pip install ollama-chat
+   ~~~
+
+
+# Starting 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 current directory to save
+your conversations.
+
+
+## Future Features
+
+In no particular order...
+
+- Save conversation as Markdown file
+
+- Conversation title edit
+
+- File / Directory / URL text inclusion in prompt
+
+- Local model management (pull, rm)
+  - [Models JSON](https://huggingface.co/api/models)
+
+- Prompt library
+
+
+## Development
+
+This package is developed using [python-build](https://github.com/craigahobbs/python-build#readme).
+It was started using [python-template](https://github.com/craigahobbs/python-template#readme) 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
+~~~

ollama_chat-0.9.0/pyproject.toml

@@ -0,0 +1,2 @@
+[build-system]
+requires = ["setuptools", "wheel"]

ollama_chat-0.9.0/setup.cfg

@@ -0,0 +1,46 @@
+[metadata]
+name = ollama-chat
+version = 0.9.0
+url = https://github.com/craigahobbs/ollama-chat
+author = Craig A. Hobbs
+author_email = craigahobbs@gmail.com
+license = MIT
+description = ollama-chat
+long_description = file:README.md
+long_description_content_type = text/markdown
+keywords = ollama-chat
+classifiers = 
+	Development Status :: 5 - Production/Stable
+	Intended Audience :: Developers
+	License :: OSI Approved :: MIT License
+	Operating System :: OS Independent
+	Programming Language :: Python :: 3.8
+	Programming Language :: Python :: 3.9
+	Programming Language :: Python :: 3.10
+	Programming Language :: Python :: 3.11
+	Programming Language :: Python :: 3.12
+	Topic :: Utilities
+
+[options]
+packages = ollama_chat
+package_dir = 
+	= src
+install_requires = 
+	chisel >= 1.2.7
+	ollama >= 0.1.9
+	waitress >= 3.0.0
+
+[options.entry_points]
+console_scripts = 
+	ollama-chat = ollama_chat.main:main
+
+[options.package_data]
+ollama_chat = \
+	static/index.html, \
+	static/ollamaChat.mds, \
+	static/ollamaChat.smd
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

ollama_chat-0.9.0/src/ollama_chat/__main__.py

@@ -0,0 +1,12 @@
+# Licensed under the MIT License
+# https://github.com/craigahobbs/ollama-chat/blob/main/LICENSE
+
+"""
+ollama-chat top-level script environment
+"""
+
+from .main import main
+
+
+if __name__ == '__main__': # pragma: no cover
+    main()

ollama_chat-0.9.0/src/ollama_chat/app.py

@@ -0,0 +1,309 @@
+# Licensed under the MIT License
+# https://github.com/craigahobbs/ollama-chat/blob/main/LICENSE
+
+"""
+The ollama-chat back-end application
+"""
+
+from contextlib import contextmanager
+import copy
+import json
+import os
+import importlib.resources as pkg_resources
+import threading
+import uuid
+
+import chisel
+import ollama
+import schema_markdown
+
+from .ollama import OllamaChat, config_conversation
+
+
+class OllamaChatApplication(chisel.Application):
+    """
+    The ollama-chat back-end API WSGI application class
+    """
+
+    __slots__ = ('config', 'chats')
+
+
+    def __init__(self, config_path):
+        super().__init__()
+        self.config = ConfigManager(config_path)
+        self.chats = {}
+
+        # Add the chisel documentation application
+        self.add_requests(chisel.create_doc_requests())
+
+        # Add the APIs
+        self.add_request(delete_conversation)
+        self.add_request(delete_conversation_exchange)
+        self.add_request(get_conversation)
+        self.add_request(get_conversations)
+        self.add_request(get_model)
+        self.add_request(get_models)
+        self.add_request(regenerate_conversation_exchange)
+        self.add_request(reply_conversation)
+        self.add_request(set_model)
+        self.add_request(start_conversation)
+        self.add_request(stop_conversation)
+
+        # Add the ollama-chat statics
+        self.add_static(
+            'index.html',
+            'text/html; charset=utf-8',
+            (('GET', None), ('GET', '/')),
+            'The Ollama Chat application HTML'
+        )
+        self.add_static(
+            'ollamaChat.bare',
+            'text/plain; charset=utf-8',
+            (('GET', None),),
+            'The Ollama Chat application BareScript'
+        )
+
+
+    def add_static(self, filename, content_type, urls, doc):
+        with pkg_resources.open_binary('ollama_chat.static', filename) as fh:
+            self.add_request(chisel.StaticRequest(
+                filename,
+                fh.read(),
+                content_type=content_type,
+                urls=urls,
+                doc=doc,
+                doc_group='Ollama Chat Statics'
+            ))
+
+
+class ConfigManager:
+    __slots__ = ('config_path', 'config_lock', 'config')
+
+
+    DEFAULT_MODEL = 'llama3:latest'
+
+
+    def __init__(self, config_path):
+        self.config_path = config_path
+        self.config_lock = threading.Lock()
+
+        # Ensure the config file exists with default config if it doesn't exist
+        if os.path.isfile(config_path):
+            with open(config_path, 'r', encoding='utf-8') as fh_config:
+                self.config = schema_markdown.validate_type(OLLAMA_CHAT_TYPES, 'OllamaChatConfig', json.loads(fh_config.read()))
+        else:
+            self.config = {'model': ConfigManager.DEFAULT_MODEL, 'conversations': []}
+
+
+    @contextmanager
+    def __call__(self, save=False):
+        # Acquire the config lock
+        self.config_lock.acquire()
+
+        try:
+            # If no model is set, set the default model
+            is_saving = save
+            if 'model' not in self.config:
+                self.config['model'] = ConfigManager.DEFAULT_MODEL
+                is_saving = True
+
+            # Yield the config on context entry
+            yield self.config
+
+            # Save the config file on context exit, if requested
+            if is_saving and not self.config.get('noSave'):
+                with open(self.config_path, 'w', encoding='utf-8') as fh_config:
+                    json.dump(self.config, fh_config, indent=4, sort_keys = True)
+        finally:
+            # Release the config lock
+            self.config_lock.release()
+
+
+# The Ollama Chat type model
+with pkg_resources.open_text('ollama_chat.static', 'ollamaChat.smd') as cm_smd:
+    OLLAMA_CHAT_TYPES = schema_markdown.parse_schema_markdown(cm_smd.read())
+
+
+@chisel.action(name='getModels', types=OLLAMA_CHAT_TYPES)
+def get_models(unused_ctx, unused_req):
+    return {
+        'models': [
+            {
+                'model': model['name'],
+                'size': model['size']
+            }
+            for model in ollama.list()['models']
+        ]
+    }
+
+
+@chisel.action(name='getModel', types=OLLAMA_CHAT_TYPES)
+def get_model(ctx, unused_req):
+    with ctx.app.config() as config:
+        return {'model': config['model']}
+
+
+@chisel.action(name='setModel', types=OLLAMA_CHAT_TYPES)
+def set_model(ctx, req):
+    with ctx.app.config(save=True) as config:
+        config['model'] = req['model']
+
+
+@chisel.action(name='getConversations', types=OLLAMA_CHAT_TYPES)
+def get_conversations(ctx, unused_req):
+    conversations = []
+    with ctx.app.config() as config:
+        for conversation in config['conversations']:
+            info = dict(conversation)
+            del info['exchanges']
+            info['generating'] = conversation['id'] in ctx.app.chats
+            conversations.append(info)
+    return {
+        'conversations': conversations
+    }
+
+
+@chisel.action(name='startConversation', types=OLLAMA_CHAT_TYPES)
+def start_conversation(ctx, req):
+    with ctx.app.config() as config:
+        # Compute the conversation title
+        user_prompt = req['user']
+        max_title_len = 50
+        if len(user_prompt) <= max_title_len:
+            title = user_prompt
+        else:
+            title_suffix = '...'
+            title = f'{user_prompt[:max_title_len - len(title_suffix)]}{title_suffix}'
+
+        # Create the new conversation object
+        id_ = str(uuid.uuid4())
+        model = config['model']
+        conversation = {
+            'id': id_,
+            'model': model,
+            'title': title,
+            'exchanges': [
+                {
+                    'user': req['user'],
+                    'model': ''
+                }
+            ]
+        }
+
+        # Add the new conversation to the application config
+        config['conversations'].insert(0, conversation)
+
+        # Start the model chat
+        ctx.app.chats[id_] = OllamaChat(ctx.app, id_)
+
+        # Return the new conversation ID
+        return {'id': id_}
+
+
+@chisel.action(name='stopConversation', types=OLLAMA_CHAT_TYPES)
+def stop_conversation(ctx, req):
+    with ctx.app.config() as config:
+        id_ = req['id']
+        conversation = config_conversation(config, id_)
+        if conversation is None:
+            raise chisel.ActionError('UnknownConversationID')
+
+        # Not generating?
+        chat = ctx.app.chats.get(id_)
+        if chat is None:
+            return
+
+        # Stop the conversation
+        chat.stop = True
+        del ctx.app.chats[id_]
+
+
+@chisel.action(name='getConversation', types=OLLAMA_CHAT_TYPES)
+def get_conversation(ctx, req):
+    with ctx.app.config() as config:
+        id_ = req['id']
+        conversation = config_conversation(config, id_)
+        if conversation is None:
+            raise chisel.ActionError('UnknownConversationID')
+
+        # Return the conversation
+        return {
+            'conversation': copy.deepcopy(conversation),
+            'generating': id_ in ctx.app.chats
+        }
+
+
+@chisel.action(name='replyConversation', types=OLLAMA_CHAT_TYPES)
+def reply_conversation(ctx, req):
+    with ctx.app.config() as config:
+        id_ = req['id']
+        conversation = config_conversation(config, id_)
+        if conversation is None:
+            raise chisel.ActionError('UnknownConversationID')
+
+        # Busy?
+        if id_ in ctx.app.chats:
+            raise chisel.ActionError('ConversationBusy')
+
+        # Add the reply exchange
+        conversation['exchanges'].append({
+            'user': req['user'],
+            'model': ''
+        })
+
+        # Start the model chat
+        ctx.app.chats[id_] = OllamaChat(ctx.app, id_)
+
+
+@chisel.action(name='deleteConversation', types=OLLAMA_CHAT_TYPES)
+def delete_conversation(ctx, req):
+    with ctx.app.config(save=True) as config:
+        id_ = req['id']
+        conversation = config_conversation(config, id_)
+        if conversation is None:
+            raise chisel.ActionError('UnknownConversationID')
+
+        # Busy?
+        if id_ in ctx.app.chats:
+            raise chisel.ActionError('ConversationBusy')
+
+        # Delete the conversation
+        config['conversations'] = [conversation for conversation in config['conversations'] if conversation['id'] != id_]
+
+
+@chisel.action(name='deleteConversationExchange', types=OLLAMA_CHAT_TYPES)
+def delete_conversation_exchange(ctx, req):
+    with ctx.app.config(save=True) as config:
+        id_ = req['id']
+        conversation = config_conversation(config, id_)
+        if conversation is None:
+            raise chisel.ActionError('UnknownConversationID')
+
+        # Busy?
+        if id_ in ctx.app.chats:
+            raise chisel.ActionError('ConversationBusy')
+
+        # Delete the most recent exchange (but not the last one)
+        exchanges = conversation['exchanges']
+        if len(exchanges) > 1:
+            del exchanges[-1]
+
+
+@chisel.action(name='regenerateConversationExchange', types=OLLAMA_CHAT_TYPES)
+def regenerate_conversation_exchange(ctx, req):
+    with ctx.app.config(save=True) as config:
+        id_ = req['id']
+        conversation = config_conversation(config, id_)
+        if conversation is None:
+            raise chisel.ActionError('UnknownConversationID')
+
+        # Busy?
+        if id_ in ctx.app.chats:
+            raise chisel.ActionError('ConversationBusy')
+
+        # Reset the most recent exchange's model response
+        exchanges = conversation['exchanges']
+        exchanges[-1]['model'] = ''
+
+        # Start the model chat
+        ctx.app.chats[id_] = OllamaChat(ctx.app, id_)

ollama_chat-0.9.0/src/ollama_chat/main.py

@@ -0,0 +1,58 @@
+# Licensed under the MIT License
+# https://github.com/craigahobbs/ollama-chat/blob/main/LICENSE
+
+"""
+ollama-chat command-line script main module
+"""
+
+import argparse
+import threading
+import webbrowser
+
+import waitress
+
+from .app import OllamaChatApplication
+
+
+def main(argv=None):
+    """
+    ollama-chat command-line script main entry point
+    """
+
+    # Command line arguments
+    parser = argparse.ArgumentParser(prog='ollama-chat')
+    parser.add_argument('-c', metavar='FILE', dest='config', default='ollama-chat.json',
+                        help='the configuration file (default is "ollama-chat.json")')
+    parser.add_argument('-p', metavar='N', dest='port', type=int, default=8080,
+                        help='the application port (default is 8080)')
+    parser.add_argument('-n', dest='no_browser', action='store_true',
+                        help="don't open a web browser")
+    parser.add_argument('-q', dest='quiet', action='store_true',
+                        help="don't display access logging")
+    args = parser.parse_args(args=argv)
+
+    # Construct the URL
+    host = '127.0.0.1'
+    url = f'http://{host}:{args.port}/'
+
+    # Launch the web browser on a thread so the WSGI application can startup first
+    if not args.no_browser:
+        webbrowser_thread = threading.Thread(target=webbrowser.open, args=(url,))
+        webbrowser_thread.daemon = True
+        webbrowser_thread.start()
+
+    # Create the WSGI application
+    wsgiapp = OllamaChatApplication(args.config)
+
+    # Wrap the WSGI application and the start_response function so we can log status and environ
+    def wsgiapp_wrap(environ, start_response):
+        def log_start_response(status, response_headers):
+            if not args.quiet:
+                print(f'ollama-chat: {status[0:3]} {environ["REQUEST_METHOD"]} {environ["PATH_INFO"]} {environ["QUERY_STRING"]}')
+            return start_response(status, response_headers)
+        return wsgiapp(environ, log_start_response)
+
+    # Host the application
+    if not args.quiet:
+        print(f'ollama-chat: Serving at {url} ...')
+    waitress.serve(wsgiapp_wrap, port=args.port)

ollama_chat-0.9.0/src/ollama_chat/ollama.py

@@ -0,0 +1,79 @@
+# Licensed under the MIT License
+# https://github.com/craigahobbs/ollama-chat/blob/main/LICENSE
+
+"""
+The ollama chat manager
+"""
+
+import threading
+
+import ollama
+
+
+class OllamaChat():
+    """
+    The ollama chat manager class
+    """
+
+    __slots__ = ('app', 'conversation_id', 'stop')
+
+
+    def __init__(self, app, conversation_id):
+        self.app = app
+        self.conversation_id = conversation_id
+        self.stop = False
+
+        # Start the chat thread
+        chat_thread = threading.Thread(target=OllamaChat.chat_thread_fn, args=(self,))
+        chat_thread.daemon = True
+        chat_thread.start()
+
+
+    @staticmethod
+    def chat_thread_fn(chat):
+        try:
+            # Create the Ollama messages from the conversation
+            messages = []
+            with chat.app.config() as config:
+                conversation = config_conversation(config, chat.conversation_id)
+                model = conversation['model']
+                for exchange in conversation['exchanges']:
+                    messages.append({'role': 'user', 'content': exchange['user']})
+                    if exchange['model'] != '':
+                        messages.append({'role': 'assistant', 'content': exchange['model']})
+
+            # Start the chat
+            stream = ollama.chat(model=model, messages=messages, stream=True)
+
+            # Stream the chat response
+            for chunk in stream:
+                # If stopped, return immediately. The chat is deleted by the stopper.
+                if chat.stop:
+                    stream.close()
+                    break
+
+                # Update the conversation
+                with chat.app.config() as config:
+                    conversation = config_conversation(config, chat.conversation_id)
+                    exchange = conversation['exchanges'][-1]
+                    exchange['model'] += chunk['message']['content']
+
+        except Exception as exc: # pylint: disable=broad-exception-caught
+            # Communicate the error
+            with chat.app.config() as config:
+                conversation = config_conversation(config, chat.conversation_id)
+                exchange = conversation['exchanges'][-1]
+                exchange['model'] += f'\n**ERROR:** {exc}'
+
+        # Save the conversation
+        with chat.app.config(save=True):
+            # Delete the application's chat entry
+            if chat.conversation_id in chat.app.chats:
+                del chat.app.chats[chat.conversation_id]
+
+
+def config_conversation(config, id_):
+    """
+    Helper to find a conversation by ID
+    """
+    return next((conv for conv in config['conversations'] if conv['id'] == id_), None)

ollama_chat-0.9.0/src/ollama_chat/static/ollamaChat.smd

@@ -0,0 +1,214 @@
+# Licensed under the MIT License
+# https://github.com/craigahobbs/ollama-chat/blob/main/LICENSE
+
+
+group "Ollama Chat JSON"
+
+
+# The Ollama Chat config file format
+struct OllamaChatConfig
+
+    # The current model name
+    optional string model
+
+    # The saved conversations
+    Conversation[] conversations
+
+    # If true, don't save the config file
+    optional bool noSave
+
+
+# The user-model conversation info
+struct ConversationInfo
+
+    # The conversation identifier
+    string id
+
+    # The model name
+    string model
+
+    # The conversation title
+    string title
+
+
+# A user-model conversation
+struct Conversation (ConversationInfo)
+
+    # The conversation's exchanges
+    ConversationExchange[len > 0] exchanges
+
+
+# A conversation user-model exchange
+struct ConversationExchange
+
+    # The user prompt
+    string(len > 0) user
+
+    # The model response
+    string model
+
+
+group "Ollama Chat API"
+
+
+# Get the current model name
+action getModels
+    urls
+        GET
+
+    output
+        # The local models
+        ModelInfo[] models
+
+
+# Model information struct
+struct ModelInfo
+
+    # The current model name
+    string model
+
+    # The model size, in bytes
+    int size
+
+
+# Get the current model name
+action getModel
+    urls
+        GET
+
+    output
+        # The current model name
+        string model
+
+
+# Set the current model name
+action setModel
+    urls
+        POST
+
+    input
+        # The model name
+        string model
+
+
+# Get the list of conversations
+action getConversations
+    urls
+        GET
+
+    output
+        # The conversations
+        ConversationInfoEx[] conversations
+
+
+# Conversation information struct with generating state
+struct ConversationInfoEx (ConversationInfo)
+
+    # If True, the latest exchange is actively generating
+    bool generating
+
+
+# Start a conversation
+action startConversation
+    urls
+        POST
+
+    input
+        # The user prompt
+        string(len > 0) user
+
+    output
+        # The new conversation ID
+        string id
+
+
+# Stop a generating conversation
+action stopConversation
+    urls
+        POST
+
+    input
+        # The conversation identifier
+        string id
+
+    errors
+        UnknownConversationID
+
+
+# Get a conversation
+action getConversation
+    urls
+        GET
+
+    query
+        # The conversation identifier
+        string id
+
+    output
+        # The conversation
+        Conversation conversation
+
+        # If True, the latest exchange is actively generating
+        bool generating
+
+    errors
+        UnknownConversationID
+
+
+# Reply to a conversation
+action replyConversation
+    urls
+        POST
+
+    input
+        # The conversation identifier
+        string id
+
+        # The user reply prompt
+        string(len > 0) user
+
+    errors
+        UnknownConversationID
+        ConversationBusy
+
+
+# Delete a conversation
+action deleteConversation
+    urls
+        POST
+
+    input
+        # The conversation identifier
+        string id
+
+    errors
+        UnknownConversationID
+        ConversationBusy
+
+
+# Delete the most recent exchange of a conversation
+action deleteConversationExchange
+    urls
+        POST
+
+    input
+        # The conversation identifier
+        string id
+
+    errors
+        UnknownConversationID
+        ConversationBusy
+
+
+# Regnerate the model's response of the most recent exchange of a conversation
+action regenerateConversationExchange
+    urls
+        POST
+
+    input
+        # The conversation identifier
+        string id
+
+    errors
+        UnknownConversationID
+        ConversationBusy

ollama_chat-0.9.0/src/ollama_chat.egg-info/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.1
+Name: ollama-chat
+Version: 0.9.0
+Summary: ollama-chat
+Home-page: https://github.com/craigahobbs/ollama-chat
+Author: Craig A. Hobbs
+Author-email: craigahobbs@gmail.com
+License: MIT
+Keywords: ollama-chat
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: chisel>=1.2.7
+Requires-Dist: ollama>=0.1.9
+Requires-Dist: waitress>=3.0.0
+
+# ollama-chat
+
+[![PyPI - Status](https://img.shields.io/pypi/status/ollama-chat)](https://pypi.org/project/ollama-chat/)
+[![PyPI](https://img.shields.io/pypi/v/ollama-chat)](https://pypi.org/project/ollama-chat/)
+[![GitHub](https://img.shields.io/github/license/craigahobbs/ollama-chat)](https://github.com/craigahobbs/ollama-chat/blob/main/LICENSE)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ollama-chat)](https://pypi.org/project/ollama-chat/)
+
+**Ollama Chat** is a simple yet useful web chat client for
+[Ollama](https://ollama.com)
+that allows you to chat locally (and privately) with
+[open-source LLMs](https://ollama.com/library).
+
+
+# Installation
+
+To get up and running with Ollama Chat follows these steps:
+
+1. Install and start [Ollama](https://ollama.com)
+
+2. Install Ollama Chat
+
+   ~~~
+   pip install ollama-chat
+   ~~~
+
+
+# Starting 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 current directory to save
+your conversations.
+
+
+## Future Features
+
+In no particular order...
+
+- Save conversation as Markdown file
+
+- Conversation title edit
+
+- File / Directory / URL text inclusion in prompt
+
+- Local model management (pull, rm)
+  - [Models JSON](https://huggingface.co/api/models)
+
+- Prompt library
+
+
+## Development
+
+This package is developed using [python-build](https://github.com/craigahobbs/python-build#readme).
+It was started using [python-template](https://github.com/craigahobbs/python-template#readme) 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
+~~~

ollama_chat-0.9.0/src/ollama_chat.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+setup.cfg
+src/ollama_chat/__init__.py
+src/ollama_chat/__main__.py
+src/ollama_chat/app.py
+src/ollama_chat/main.py
+src/ollama_chat/ollama.py
+src/ollama_chat.egg-info/PKG-INFO
+src/ollama_chat.egg-info/SOURCES.txt
+src/ollama_chat.egg-info/dependency_links.txt
+src/ollama_chat.egg-info/entry_points.txt
+src/ollama_chat.egg-info/requires.txt
+src/ollama_chat.egg-info/top_level.txt
+src/ollama_chat/static/ollamaChat.smd

ollama_chat-0.9.0/src/ollama_chat.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ollama_chat-0.9.0/src/ollama_chat.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ollama-chat = ollama_chat.main:main

ollama_chat-0.9.0/src/ollama_chat.egg-info/requires.txt

@@ -0,0 +1,3 @@
+chisel>=1.2.7
+ollama>=0.1.9
+waitress>=3.0.0

ollama_chat-0.9.0/src/ollama_chat.egg-info/top_level.txt

@@ -0,0 +1 @@
+ollama_chat