ngpt 2.8.0__tar.gz → 2.9.1__tar.gz

{ngpt-2.8.0 → ngpt-2.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ngpt
-Version: 2.8.0
+Version: 2.9.1
 Summary: A lightweight Python CLI and library for interacting with OpenAI-compatible APIs, supporting both official and self-hosted LLM endpoints.
 Project-URL: Homepage, https://github.com/nazdridoy/ngpt
 Project-URL: Repository, https://github.com/nazdridoy/ngpt
@@ -28,10 +28,9 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
 Requires-Python: >=3.8
+Requires-Dist: prompt-toolkit>=3.0.0
 Requires-Dist: requests>=2.31.0
-Provides-Extra: full
-Requires-Dist: prompt-toolkit>=3.0.0; extra == 'full'
-Requires-Dist: rich>=10.0.0; extra == 'full'
+Requires-Dist: rich>=10.0.0
 Description-Content-Type: text/markdown
 
 # nGPT
@@ -43,6 +42,9 @@ Description-Content-Type: text/markdown
 
 A lightweight Python CLI and library for interacting with OpenAI-compatible APIs, supporting both official and self-hosted LLM endpoints.
 
+![2025-04-23_16-18-01](https://github.com/user-attachments/assets/b8e58926-5165-4352-b48b-9f4a982da86e)
+
+
 ## Table of Contents
 - [Quick Start](#quick-start)
 - [Features](#features)
@@ -52,6 +54,7 @@ A lightweight Python CLI and library for interacting with OpenAI-compatible APIs
   - [Documentation](https://nazdridoy.github.io/ngpt/)
   - [CLI Tool](#as-a-cli-tool)
   - [Python Library](#as-a-library)
+  - [CLI Framework](#as-a-cli-framework)
 - [Configuration](#configuration)
   - [Command Line Options](#command-line-options)
   - [CLI Configuration](#cli-configuration)
@@ -64,11 +67,14 @@ A lightweight Python CLI and library for interacting with OpenAI-compatible APIs
 ## Quick Start
 
 ```bash
-# Install
+# Install with pip
 pip install ngpt
 
-# Install with additional features
-pip install "ngpt[full]"
+# Or install with uv (faster)
+uv pip install ngpt
+
+# Or install globally as a CLI tool (recommended)
+uv tool install ngpt
 
 # Chat with default settings
 ngpt "Tell me about quantum computing"
@@ -114,8 +120,8 @@ For more examples and detailed usage, visit the [CLI Usage Guide](https://nazdri
 
 ## Features
 
-- ✅ **Dual Mode**: Use as a CLI tool or import as a Python library
-- 🪶 **Lightweight**: Minimal dependencies (just `requests`)
+- ✅ **Versatile**: Use as a CLI tool, Python library, or CLI framework for building custom tools
+- 🪶 **Lightweight**: Minimal dependencies with everything you need included
 - 🔄 **API Flexibility**: Works with OpenAI, Ollama, Groq, and any compatible endpoint
 - 💬 **Interactive Chat**: Continuous conversation with memory in modern UI
 - 📊 **Streaming Responses**: Real-time output for better user experience
@@ -128,6 +134,7 @@ For more examples and detailed usage, visit the [CLI Usage Guide](https://nazdri
 - 📝 **Rich Multiline Editor**: Interactive multiline text input with syntax highlighting and intuitive controls
 - 🎭 **System Prompts**: Customize model behavior with custom system prompts
 - 📃 **Conversation Logging**: Save your conversations to text files for later reference
+- 🧰 **CLI Components**: Reusable components for building custom AI-powered command-line tools
 
 See the [Feature Overview](https://nazdridoy.github.io/ngpt/overview.html) for more details.
 
@@ -141,25 +148,25 @@ Key documentation sections:
 - [Installation Guide](https://nazdridoy.github.io/ngpt/installation.html)
 - [CLI Usage Guide](https://nazdridoy.github.io/ngpt/usage/cli_usage.html)
 - [Library Usage Guide](https://nazdridoy.github.io/ngpt/usage/library_usage.html)
+- [CLI Framework Guide](https://nazdridoy.github.io/ngpt/usage/cli_framework.html)
 - [Configuration Guide](https://nazdridoy.github.io/ngpt/configuration.html)
 - [Examples & Tutorials](https://nazdridoy.github.io/ngpt/examples/basic.html)
 
 ## Installation
 
 ```bash
-# Basic installation (minimal dependencies)
+# Installation with pip
 pip install ngpt
 
-# Full installation with all features (recommended)
-pip install "ngpt[full]"
+# Or install with uv (faster installation)
+uv pip install ngpt
+
+# Or install globally as a CLI tool (recommended for command-line usage)
+uv tool install ngpt
 ```
 
 Requires Python 3.8 or newer.
 
-The full installation includes:
-- Enhanced markdown rendering with syntax highlighting
-- Improved interactive input experience with multiline editing
-
 For detailed installation instructions, see the [Installation Guide](https://nazdridoy.github.io/ngpt/installation.html).
 
 ## Usage
@@ -279,6 +286,49 @@ print(code)
 
 For advanced usage patterns and integrations, check out the [Advanced Examples](https://nazdridoy.github.io/ngpt/examples/advanced.html).
 
+### As a CLI Framework
+
+nGPT can also be used as a framework to build your own AI-powered command-line tools. You can leverage nGPT's pre-built CLI components to quickly develop sophisticated CLI applications.
+
+```python
+from ngpt import NGPTClient, load_config
+from ngpt.cli.main import interactive_chat_session
+from ngpt.cli.renderers import prettify_markdown
+from ngpt.cli.formatters import ColoredHelpFormatter
+import argparse
+
+# Create a custom CLI tool with colorized help
+parser = argparse.ArgumentParser(
+    description="Specialized Code Assistant",
+    formatter_class=ColoredHelpFormatter
+)
+parser.add_argument("prompt", nargs="?", help="Code description")
+parser.add_argument("--language", "-l", default="python", help="Programming language")
+parser.add_argument("--interactive", "-i", action="store_true", help="Start interactive mode")
+args = parser.parse_args()
+
+# Initialize client
+client = NGPTClient(**load_config())
+
+# Use interactive session for conversation
+if args.interactive:
+    system_prompt = f"You are an expert {args.language} developer. Provide clear, detailed answers."
+    interactive_chat_session(client=client, preprompt=system_prompt, prettify=True)
+elif args.prompt:
+    # Generate and prettify code
+    code = client.generate_code(args.prompt, language=args.language)
+    print(prettify_markdown(f"```{args.language}\n{code}\n```"))
+```
+
+This allows you to build specialized AI tools like:
+- Code generators for specific languages or frameworks
+- Domain-specific assistants (SQL, legal, finance, etc.)
+- Documentation generators
+- Translation tools
+- And much more
+
+For detailed information about building CLI tools with nGPT, see the [CLI Framework Guide](https://nazdridoy.github.io/ngpt/usage/cli_framework.html) and explore the [CLI Component Examples](https://nazdridoy.github.io/ngpt/examples/cli_components.html).
+
 ## Configuration
 
 ### Command Line Options
@@ -305,13 +355,15 @@ You can configure the client using the following options:
 | `--config` | Path to a custom configuration file or, when used without a value, enters interactive configuration mode |
 | `--config-index` | Index of the configuration to use (default: 0) |
 | `--provider` | Provider name to identify the configuration to use (alternative to --config-index) |
-| `--remove` | Remove the configuration at the specified index (requires --config and --config-index) |
+| `--remove` | Remove the configuration at the specified index (requires --config and --config-index or --provider) |
 | `--show-config` | Show configuration details and exit |
 | `--all` | Used with `--show-config` to display all configurations |
 | `-i, --interactive` | Start an interactive chat session with stylish UI, conversation history, and special commands |
 | `-s, --shell` | Generate and execute shell commands |
 | `-c, --code` | Generate clean code output |
 | `-t, --text` | Open interactive multiline editor for complex prompts |
+| `--language` | Programming language to generate code in (for code mode, default: python) |
+| `--cli-config` | Manage CLI configuration settings (set, get, unset, list, help) |
 | `-v, --version` | Show version information |
 
 For a complete reference of all available options, see the [CLI Usage Guide](https://nazdridoy.github.io/ngpt/usage/cli_usage.html).

{ngpt-2.8.0 → ngpt-2.9.1}/README.md

@@ -7,6 +7,9 @@
 
 A lightweight Python CLI and library for interacting with OpenAI-compatible APIs, supporting both official and self-hosted LLM endpoints.
 
+![2025-04-23_16-18-01](https://github.com/user-attachments/assets/b8e58926-5165-4352-b48b-9f4a982da86e)
+
+
 ## Table of Contents
 - [Quick Start](#quick-start)
 - [Features](#features)
@@ -16,6 +19,7 @@ A lightweight Python CLI and library for interacting with OpenAI-compatible APIs
   - [Documentation](https://nazdridoy.github.io/ngpt/)
   - [CLI Tool](#as-a-cli-tool)
   - [Python Library](#as-a-library)
+  - [CLI Framework](#as-a-cli-framework)
 - [Configuration](#configuration)
   - [Command Line Options](#command-line-options)
   - [CLI Configuration](#cli-configuration)
@@ -28,11 +32,14 @@ A lightweight Python CLI and library for interacting with OpenAI-compatible APIs
 ## Quick Start
 
 ```bash
-# Install
+# Install with pip
 pip install ngpt
 
-# Install with additional features
-pip install "ngpt[full]"
+# Or install with uv (faster)
+uv pip install ngpt
+
+# Or install globally as a CLI tool (recommended)
+uv tool install ngpt
 
 # Chat with default settings
 ngpt "Tell me about quantum computing"
@@ -78,8 +85,8 @@ For more examples and detailed usage, visit the [CLI Usage Guide](https://nazdri
 
 ## Features
 
-- ✅ **Dual Mode**: Use as a CLI tool or import as a Python library
-- 🪶 **Lightweight**: Minimal dependencies (just `requests`)
+- ✅ **Versatile**: Use as a CLI tool, Python library, or CLI framework for building custom tools
+- 🪶 **Lightweight**: Minimal dependencies with everything you need included
 - 🔄 **API Flexibility**: Works with OpenAI, Ollama, Groq, and any compatible endpoint
 - 💬 **Interactive Chat**: Continuous conversation with memory in modern UI
 - 📊 **Streaming Responses**: Real-time output for better user experience
@@ -92,6 +99,7 @@ For more examples and detailed usage, visit the [CLI Usage Guide](https://nazdri
 - 📝 **Rich Multiline Editor**: Interactive multiline text input with syntax highlighting and intuitive controls
 - 🎭 **System Prompts**: Customize model behavior with custom system prompts
 - 📃 **Conversation Logging**: Save your conversations to text files for later reference
+- 🧰 **CLI Components**: Reusable components for building custom AI-powered command-line tools
 
 See the [Feature Overview](https://nazdridoy.github.io/ngpt/overview.html) for more details.
 
@@ -105,25 +113,25 @@ Key documentation sections:
 - [Installation Guide](https://nazdridoy.github.io/ngpt/installation.html)
 - [CLI Usage Guide](https://nazdridoy.github.io/ngpt/usage/cli_usage.html)
 - [Library Usage Guide](https://nazdridoy.github.io/ngpt/usage/library_usage.html)
+- [CLI Framework Guide](https://nazdridoy.github.io/ngpt/usage/cli_framework.html)
 - [Configuration Guide](https://nazdridoy.github.io/ngpt/configuration.html)
 - [Examples & Tutorials](https://nazdridoy.github.io/ngpt/examples/basic.html)
 
 ## Installation
 
 ```bash
-# Basic installation (minimal dependencies)
+# Installation with pip
 pip install ngpt
 
-# Full installation with all features (recommended)
-pip install "ngpt[full]"
+# Or install with uv (faster installation)
+uv pip install ngpt
+
+# Or install globally as a CLI tool (recommended for command-line usage)
+uv tool install ngpt
 ```
 
 Requires Python 3.8 or newer.
 
-The full installation includes:
-- Enhanced markdown rendering with syntax highlighting
-- Improved interactive input experience with multiline editing
-
 For detailed installation instructions, see the [Installation Guide](https://nazdridoy.github.io/ngpt/installation.html).
 
 ## Usage
@@ -243,6 +251,49 @@ print(code)
 
 For advanced usage patterns and integrations, check out the [Advanced Examples](https://nazdridoy.github.io/ngpt/examples/advanced.html).
 
+### As a CLI Framework
+
+nGPT can also be used as a framework to build your own AI-powered command-line tools. You can leverage nGPT's pre-built CLI components to quickly develop sophisticated CLI applications.
+
+```python
+from ngpt import NGPTClient, load_config
+from ngpt.cli.main import interactive_chat_session
+from ngpt.cli.renderers import prettify_markdown
+from ngpt.cli.formatters import ColoredHelpFormatter
+import argparse
+
+# Create a custom CLI tool with colorized help
+parser = argparse.ArgumentParser(
+    description="Specialized Code Assistant",
+    formatter_class=ColoredHelpFormatter
+)
+parser.add_argument("prompt", nargs="?", help="Code description")
+parser.add_argument("--language", "-l", default="python", help="Programming language")
+parser.add_argument("--interactive", "-i", action="store_true", help="Start interactive mode")
+args = parser.parse_args()
+
+# Initialize client
+client = NGPTClient(**load_config())
+
+# Use interactive session for conversation
+if args.interactive:
+    system_prompt = f"You are an expert {args.language} developer. Provide clear, detailed answers."
+    interactive_chat_session(client=client, preprompt=system_prompt, prettify=True)
+elif args.prompt:
+    # Generate and prettify code
+    code = client.generate_code(args.prompt, language=args.language)
+    print(prettify_markdown(f"```{args.language}\n{code}\n```"))
+```
+
+This allows you to build specialized AI tools like:
+- Code generators for specific languages or frameworks
+- Domain-specific assistants (SQL, legal, finance, etc.)
+- Documentation generators
+- Translation tools
+- And much more
+
+For detailed information about building CLI tools with nGPT, see the [CLI Framework Guide](https://nazdridoy.github.io/ngpt/usage/cli_framework.html) and explore the [CLI Component Examples](https://nazdridoy.github.io/ngpt/examples/cli_components.html).
+
 ## Configuration
 
 ### Command Line Options
@@ -269,13 +320,15 @@ You can configure the client using the following options:
 | `--config` | Path to a custom configuration file or, when used without a value, enters interactive configuration mode |
 | `--config-index` | Index of the configuration to use (default: 0) |
 | `--provider` | Provider name to identify the configuration to use (alternative to --config-index) |
-| `--remove` | Remove the configuration at the specified index (requires --config and --config-index) |
+| `--remove` | Remove the configuration at the specified index (requires --config and --config-index or --provider) |
 | `--show-config` | Show configuration details and exit |
 | `--all` | Used with `--show-config` to display all configurations |
 | `-i, --interactive` | Start an interactive chat session with stylish UI, conversation history, and special commands |
 | `-s, --shell` | Generate and execute shell commands |
 | `-c, --code` | Generate clean code output |
 | `-t, --text` | Open interactive multiline editor for complex prompts |
+| `--language` | Programming language to generate code in (for code mode, default: python) |
+| `--cli-config` | Manage CLI configuration settings (set, get, unset, list, help) |
 | `-v, --version` | Show version information |
 
 For a complete reference of all available options, see the [CLI Usage Guide](https://nazdridoy.github.io/ngpt/usage/cli_usage.html).

{ngpt-2.8.0 → ngpt-2.9.1}/docs/README.md

@@ -1,21 +1,28 @@
 # nGPT Documentation
 
-Welcome to the documentation for nGPT, a lightweight Python CLI and library for interacting with OpenAI-compatible APIs, supporting both official and self-hosted LLM endpoints.
+Welcome to the documentation for nGPT, a lightweight Python CLI and library for interacting with OpenAI-compatible APIs, supporting both official and self-hosted LLM endpoints. nGPT offers three main modes of use:
+
+- A command-line interface (CLI) tool for quick AI interactions
+- A Python library for integration into your applications
+- A CLI framework for building your own AI-powered command-line tools
 
 ## Table of Contents
 
 - [Overview](overview.md)
 - [Installation](installation.md)
 - [Usage](usage/README.md)
-  - [Library Usage](usage/library_usage.md)
   - [CLI Usage](usage/cli_usage.md)
+  - [Library Usage](usage/library_usage.md)
+  - [CLI Framework](usage/cli_framework.md)
 - [API Reference](api/README.md)
   - [NGPTClient](api/client.md)
   - [Configuration](api/config.md)
+  - [CLI Components](api/cli.md)
 - [Examples](examples/README.md)
   - [Basic Examples](examples/basic.md)
   - [Advanced Examples](examples/advanced.md)
   - [Custom Integrations](examples/integrations.md)
+  - [CLI Component Examples](examples/cli_components.md)
 - [Configuration](configuration.md)
 - [Contributing](CONTRIBUTING.md)
 - [License](LICENSE.md)
@@ -24,4 +31,6 @@ Welcome to the documentation for nGPT, a lightweight Python CLI and library for
 
 For a quick start, refer to the [Installation](installation.md) and [Usage](usage/README.md) guides.
 
-If you're primarily interested in using nGPT as a library in your Python projects, head directly to the [Library Usage](usage/library_usage.md) guide. 
+If you're primarily interested in using nGPT as a library in your Python projects, head directly to the [Library Usage](usage/library_usage.md) guide.
+
+For creating your own CLI tools using nGPT's components, check out the [CLI Framework](usage/cli_framework.md) guide and the [CLI Component Examples](examples/cli_components.md).