commandchat 0.0.13__tar.gz → 0.0.15__tar.gz

commandchat-0.0.15/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: commandchat
+Version: 0.0.15
+Summary: Command-line chat client for OpenAI and Azure OpenAI models.
+Author-email: tao <xxx.tao.c@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/xoto/commandchat
+Project-URL: Issues, https://github.com/xoto/commandchat/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click
+Requires-Dist: openai
+Requires-Dist: Pillow
+Requires-Dist: prompt_toolkit
+Requires-Dist: Pygments
+Requires-Dist: pyperclip
+Requires-Dist: questionary
+Requires-Dist: requests
+Requires-Dist: rich
+Dynamic: license-file
+
+[English](README.md) | [中文](README-zh.md)
+
+# CommandChat
+
+`commandchat` provides the `occ` CLI for chatting with OpenAI or Azure OpenAI models from your terminal.
+
+## Features
+
+- Interactive CLI chat with `occ chat`
+- Profile-based configuration for multiple OpenAI / Azure OpenAI accounts
+- Prompt template management with built-in and custom prompts
+- Prompt selection per command or as a profile default
+- Experimental image generation command
+
+## Requirements
+
+- Python 3.8+
+- A terminal with `pip`
+- An OpenAI-compatible API key or Azure OpenAI configuration
+
+## Install
+
+```bash
+pip3 install commandchat
+```
+
+If you manage multiple Python versions locally:
+
+```bash
+python3 -m pip install commandchat
+```
+
+## Quick start
+
+### 1. Configure your first profile
+
+```bash
+occ configure
+```
+
+This opens the interactive configuration flow and writes local settings under `~/.occ/`.
+
+### 2. Start chatting
+
+```bash
+occ chat "Hello, introduce yourself briefly."
+```
+
+You can also start interactive multiline input:
+
+```bash
+occ chat
+```
+
+Inside interactive chat, you can use slash commands:
+
+- `/` to open the shortcut command menu
+- `/pmp`, `/p`, or `/prompt` to list prompts and switch the active prompt template
+- `/m` or `/model` to list models and switch the active model
+- `/q` to exit the chat session
+- `/help` to show the help panel again
+
+When you switch prompts with `/pmp` or models with `/m`, the CLI will ask whether you want to keep the current context or start a fresh chat session with a new session id.
+
+Interactive chat also shows a bottom status bar with the current prompt, model, and session id.
+
+### 3. Use prompt templates
+
+```bash
+occ prompt list
+occ chat -pt translate "你好世界"
+occ chat -pt improve "I wants to go to school yesterday"
+```
+
+### 4. Work with multiple profiles
+
+```bash
+occ configure profile -p work
+occ configure list
+occ chat -p work "Summarize today's priorities"
+```
+
+## Common commands
+
+| Command | Description |
+| --- | --- |
+| `occ configure` | Open the interactive configuration menu |
+| `occ configure profile -p <name>` | Create or update a profile |
+| `occ configure list` | List configured profiles |
+| `occ configure delete <name>` | Delete a profile |
+| `occ chat "message"` | Send a one-off message |
+| `occ chat` | Start an interactive chat session |
+| `occ chat -p <profile> -m <model> "message"` | Use a specific profile/model |
+| `occ chat -pt <prompt_key> "message"` | Chat with a predefined prompt |
+| `occ chat` + `/` | Open the interactive shortcut menu |
+| `occ chat` + `/pmp` / `/p` / `/prompt` | Switch prompt inside interactive chat |
+| `occ chat` + `/m` / `/model` | Switch model inside interactive chat |
+| `occ prompt list` | List prompt templates |
+| `occ prompt show <key>` | Show prompt details |
+| `occ prompt add <key> -n <name> -d <desc> -s <prompt>` | Add a custom prompt |
+| `occ image -desc "..." -size m` | Generate images |
+
+## Files created locally
+
+- `~/.occ/config`: profile and model configuration
+- `~/.occ/prompts.json`: custom prompt templates
+
+## Packaging and PyPI
+
+This project now uses `pyproject.toml` as the single source of truth for packaging metadata.
+
+- `README.md` is configured as `project.readme`, so PyPI renders this file on the project page.
+- `README-zh.md` is kept for the GitHub repository and Chinese-language documentation.
+- To update the PyPI project page content, update `README.md`, bump the version in `pyproject.toml`, and publish a new release.
+
+### Automatic publishing with GitHub Actions
+
+The repository includes `.github/workflows/publish-to-pypi.yml`.
+
+On pushes to `master` or manual runs, it will:
+
+1. Check whether the version in `pyproject.toml` changed
+2. Build the sdist and wheel from `pyproject.toml`
+3. Run `twine check dist/*`
+4. Publish to PyPI via Trusted Publishing (OIDC)
+
+Because the package metadata points to `README.md`, each new PyPI release also refreshes the PyPI homepage description.
+
+## Manual build
+
+```bash
+python3 -m pip install build twine
+python3 -m build
+python3 -m twine check dist/*
+```
+
+## Uninstall
+
+```bash
+pip3 uninstall commandchat
+```
+
+## Feedback
+
+- `xxx.tao.c@gmail.com`
+- `xoto@outlook.be`
+
+## License
+
+MIT
+

commandchat-0.0.15/README.md

@@ -0,0 +1,151 @@
+[English](README.md) | [中文](README-zh.md)
+
+# CommandChat
+
+`commandchat` provides the `occ` CLI for chatting with OpenAI or Azure OpenAI models from your terminal.
+
+## Features
+
+- Interactive CLI chat with `occ chat`
+- Profile-based configuration for multiple OpenAI / Azure OpenAI accounts
+- Prompt template management with built-in and custom prompts
+- Prompt selection per command or as a profile default
+- Experimental image generation command
+
+## Requirements
+
+- Python 3.8+
+- A terminal with `pip`
+- An OpenAI-compatible API key or Azure OpenAI configuration
+
+## Install
+
+```bash
+pip3 install commandchat
+```
+
+If you manage multiple Python versions locally:
+
+```bash
+python3 -m pip install commandchat
+```
+
+## Quick start
+
+### 1. Configure your first profile
+
+```bash
+occ configure
+```
+
+This opens the interactive configuration flow and writes local settings under `~/.occ/`.
+
+### 2. Start chatting
+
+```bash
+occ chat "Hello, introduce yourself briefly."
+```
+
+You can also start interactive multiline input:
+
+```bash
+occ chat
+```
+
+Inside interactive chat, you can use slash commands:
+
+- `/` to open the shortcut command menu
+- `/pmp`, `/p`, or `/prompt` to list prompts and switch the active prompt template
+- `/m` or `/model` to list models and switch the active model
+- `/q` to exit the chat session
+- `/help` to show the help panel again
+
+When you switch prompts with `/pmp` or models with `/m`, the CLI will ask whether you want to keep the current context or start a fresh chat session with a new session id.
+
+Interactive chat also shows a bottom status bar with the current prompt, model, and session id.
+
+### 3. Use prompt templates
+
+```bash
+occ prompt list
+occ chat -pt translate "你好世界"
+occ chat -pt improve "I wants to go to school yesterday"
+```
+
+### 4. Work with multiple profiles
+
+```bash
+occ configure profile -p work
+occ configure list
+occ chat -p work "Summarize today's priorities"
+```
+
+## Common commands
+
+| Command | Description |
+| --- | --- |
+| `occ configure` | Open the interactive configuration menu |
+| `occ configure profile -p <name>` | Create or update a profile |
+| `occ configure list` | List configured profiles |
+| `occ configure delete <name>` | Delete a profile |
+| `occ chat "message"` | Send a one-off message |
+| `occ chat` | Start an interactive chat session |
+| `occ chat -p <profile> -m <model> "message"` | Use a specific profile/model |
+| `occ chat -pt <prompt_key> "message"` | Chat with a predefined prompt |
+| `occ chat` + `/` | Open the interactive shortcut menu |
+| `occ chat` + `/pmp` / `/p` / `/prompt` | Switch prompt inside interactive chat |
+| `occ chat` + `/m` / `/model` | Switch model inside interactive chat |
+| `occ prompt list` | List prompt templates |
+| `occ prompt show <key>` | Show prompt details |
+| `occ prompt add <key> -n <name> -d <desc> -s <prompt>` | Add a custom prompt |
+| `occ image -desc "..." -size m` | Generate images |
+
+## Files created locally
+
+- `~/.occ/config`: profile and model configuration
+- `~/.occ/prompts.json`: custom prompt templates
+
+## Packaging and PyPI
+
+This project now uses `pyproject.toml` as the single source of truth for packaging metadata.
+
+- `README.md` is configured as `project.readme`, so PyPI renders this file on the project page.
+- `README-zh.md` is kept for the GitHub repository and Chinese-language documentation.
+- To update the PyPI project page content, update `README.md`, bump the version in `pyproject.toml`, and publish a new release.
+
+### Automatic publishing with GitHub Actions
+
+The repository includes `.github/workflows/publish-to-pypi.yml`.
+
+On pushes to `master` or manual runs, it will:
+
+1. Check whether the version in `pyproject.toml` changed
+2. Build the sdist and wheel from `pyproject.toml`
+3. Run `twine check dist/*`
+4. Publish to PyPI via Trusted Publishing (OIDC)
+
+Because the package metadata points to `README.md`, each new PyPI release also refreshes the PyPI homepage description.
+
+## Manual build
+
+```bash
+python3 -m pip install build twine
+python3 -m build
+python3 -m twine check dist/*
+```
+
+## Uninstall
+
+```bash
+pip3 uninstall commandchat
+```
+
+## Feedback
+
+- `xxx.tao.c@gmail.com`
+- `xoto@outlook.be`
+
+## License
+
+MIT
+

commandchat-0.0.15/commandchat.egg-info/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: commandchat
+Version: 0.0.15
+Summary: Command-line chat client for OpenAI and Azure OpenAI models.
+Author-email: tao <xxx.tao.c@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/xoto/commandchat
+Project-URL: Issues, https://github.com/xoto/commandchat/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click
+Requires-Dist: openai
+Requires-Dist: Pillow
+Requires-Dist: prompt_toolkit
+Requires-Dist: Pygments
+Requires-Dist: pyperclip
+Requires-Dist: questionary
+Requires-Dist: requests
+Requires-Dist: rich
+Dynamic: license-file
+
+[English](README.md) | [中文](README-zh.md)
+
+# CommandChat
+
+`commandchat` provides the `occ` CLI for chatting with OpenAI or Azure OpenAI models from your terminal.
+
+## Features
+
+- Interactive CLI chat with `occ chat`
+- Profile-based configuration for multiple OpenAI / Azure OpenAI accounts
+- Prompt template management with built-in and custom prompts
+- Prompt selection per command or as a profile default
+- Experimental image generation command
+
+## Requirements
+
+- Python 3.8+
+- A terminal with `pip`
+- An OpenAI-compatible API key or Azure OpenAI configuration
+
+## Install
+
+```bash
+pip3 install commandchat
+```
+
+If you manage multiple Python versions locally:
+
+```bash
+python3 -m pip install commandchat
+```
+
+## Quick start
+
+### 1. Configure your first profile
+
+```bash
+occ configure
+```
+
+This opens the interactive configuration flow and writes local settings under `~/.occ/`.
+
+### 2. Start chatting
+
+```bash
+occ chat "Hello, introduce yourself briefly."
+```
+
+You can also start interactive multiline input:
+
+```bash
+occ chat
+```
+
+Inside interactive chat, you can use slash commands:
+
+- `/` to open the shortcut command menu
+- `/pmp`, `/p`, or `/prompt` to list prompts and switch the active prompt template
+- `/m` or `/model` to list models and switch the active model
+- `/q` to exit the chat session
+- `/help` to show the help panel again
+
+When you switch prompts with `/pmp` or models with `/m`, the CLI will ask whether you want to keep the current context or start a fresh chat session with a new session id.
+
+Interactive chat also shows a bottom status bar with the current prompt, model, and session id.
+
+### 3. Use prompt templates
+
+```bash
+occ prompt list
+occ chat -pt translate "你好世界"
+occ chat -pt improve "I wants to go to school yesterday"
+```
+
+### 4. Work with multiple profiles
+
+```bash
+occ configure profile -p work
+occ configure list
+occ chat -p work "Summarize today's priorities"
+```
+
+## Common commands
+
+| Command | Description |
+| --- | --- |
+| `occ configure` | Open the interactive configuration menu |
+| `occ configure profile -p <name>` | Create or update a profile |
+| `occ configure list` | List configured profiles |
+| `occ configure delete <name>` | Delete a profile |
+| `occ chat "message"` | Send a one-off message |
+| `occ chat` | Start an interactive chat session |
+| `occ chat -p <profile> -m <model> "message"` | Use a specific profile/model |
+| `occ chat -pt <prompt_key> "message"` | Chat with a predefined prompt |
+| `occ chat` + `/` | Open the interactive shortcut menu |
+| `occ chat` + `/pmp` / `/p` / `/prompt` | Switch prompt inside interactive chat |
+| `occ chat` + `/m` / `/model` | Switch model inside interactive chat |
+| `occ prompt list` | List prompt templates |
+| `occ prompt show <key>` | Show prompt details |
+| `occ prompt add <key> -n <name> -d <desc> -s <prompt>` | Add a custom prompt |
+| `occ image -desc "..." -size m` | Generate images |
+
+## Files created locally
+
+- `~/.occ/config`: profile and model configuration
+- `~/.occ/prompts.json`: custom prompt templates
+
+## Packaging and PyPI
+
+This project now uses `pyproject.toml` as the single source of truth for packaging metadata.
+
+- `README.md` is configured as `project.readme`, so PyPI renders this file on the project page.
+- `README-zh.md` is kept for the GitHub repository and Chinese-language documentation.
+- To update the PyPI project page content, update `README.md`, bump the version in `pyproject.toml`, and publish a new release.
+
+### Automatic publishing with GitHub Actions
+
+The repository includes `.github/workflows/publish-to-pypi.yml`.
+
+On pushes to `master` or manual runs, it will:
+
+1. Check whether the version in `pyproject.toml` changed
+2. Build the sdist and wheel from `pyproject.toml`
+3. Run `twine check dist/*`
+4. Publish to PyPI via Trusted Publishing (OIDC)
+
+Because the package metadata points to `README.md`, each new PyPI release also refreshes the PyPI homepage description.
+
+## Manual build
+
+```bash
+python3 -m pip install build twine
+python3 -m build
+python3 -m twine check dist/*
+```
+
+## Uninstall
+
+```bash
+pip3 uninstall commandchat
+```
+
+## Feedback
+
+- `xxx.tao.c@gmail.com`
+- `xoto@outlook.be`
+
+## License
+
+MIT
+

{commandchat-0.0.13 → commandchat-0.0.15}/commandchat.egg-info/SOURCES.txt

@@ -1,7 +1,6 @@
 LICENSE
 README.md
 pyproject.toml
-setup.py
 commandchat.egg-info/PKG-INFO
 commandchat.egg-info/SOURCES.txt
 commandchat.egg-info/dependency_links.txt
@@ -13,8 +12,17 @@ occ/ConvertLogToMarkDown.py
 occ/__init__.py
 occ/command/__init__.py
 occ/command/__main__.py
+occ/command/commands/__init__.py
+occ/command/commands/chat.py
+occ/command/commands/image.py
+occ/command/commands/profile.py
+occ/command/commands/prompt.py
+occ/command/interactive/__init__.py
+occ/command/interactive/profile_menu.py
+occ/command/interactive/prompt_menu.py
 occ/commons/__init__.py
 occ/commons/config.py
+occ/commons/prompts.py
 occ/configuration/__init__.py
 occ/configuration/profile_config.py
 occ/utils/CommonUtil.py

{commandchat-0.0.13 → commandchat-0.0.15}/commandchat.egg-info/requires.txt

@@ -1,8 +1,9 @@
 click
-Image
 openai
+Pillow
 prompt_toolkit
+Pygments
 pyperclip
-rich
-requests
 questionary
+requests
+rich

{commandchat-0.0.13 → commandchat-0.0.15}/occ/CommandChat.py

@@ -9,7 +9,6 @@ from dataclasses import dataclass
 
 from openai import AzureOpenAI
 from openai import OpenAI
-from openai.types.chat.chat_completion_chunk import Choice
 from prompt_toolkit import print_formatted_text, HTML, Application
 from prompt_toolkit.clipboard.pyperclip import PyperclipClipboard
 from prompt_toolkit.layout import Layout, HSplit
@@ -58,7 +57,7 @@ class CommandChat:
     partial_text = []
     role = None
 
-    def __init__(self, profile=None, chat_log_id=None, model=None):
+    def __init__(self, profile=None, chat_log_id=None, model=None, system_message=None):
         now = time.strftime("%Y%m%d", time.localtime())
         self.profile = profile or DEFAULT_PROFILE
         self.api_server_type = get_env(self.profile, "api_server_type")
@@ -92,6 +91,17 @@ class CommandChat:
                 except json.JSONDecodeError:
                     continue
         
+        # Add system message if provided
+        if system_message:
+            # Check if there's already a system message at the beginning
+            has_system = len(self.messages) > 0 and self.messages[0].get('role') == 'system'
+            if has_system:
+                # Replace existing system message
+                self.messages[0] = {"role": "system", "content": system_message}
+            else:
+                # Insert system message at the beginning
+                self.messages.insert(0, {"role": "system", "content": system_message})
+        
         # Initialize client based on API server type
         if self.api_server_type == "azure-openai":
             # For Azure OpenAI, we'll initialize client per model in chat method

commandchat-0.0.15/occ/command/__main__.py

@@ -0,0 +1,43 @@
+"""
+OpenAI CommandChat - Command Line Interface
+
+Main entry point for the occ CLI tool.
+"""
+
+from __future__ import absolute_import
+
+import importlib.metadata
+import click
+
+# Import command modules
+from occ.command.commands.prompt import prompt
+from occ.command.commands.profile import configure
+from occ.command.commands.chat import chat
+from occ.command.commands.image import image
+
+
+VERSION = importlib.metadata.version("commandchat")
+
+
+@click.group()
+@click.version_option(version=VERSION, prog_name='openai-commandchat')
+def cli():
+    """OpenAI CommandChat - AI-powered command-line chat tool"""
+    pass
+
+
+# Register commands
+cli.add_command(configure)
+cli.add_command(chat)
+cli.add_command(prompt)
+cli.add_command(image)
+
+
+def main():
+    """Main entry point"""
+    cli()
+
+
+if __name__ == '__main__':
+    main()
+

commandchat-0.0.15/occ/command/commands/__init__.py

@@ -0,0 +1,2 @@
+"""Command modules for occ CLI"""
+