ngpt 2.8.0__py3-none-any.whl → 2.9.1__py3-none-any.whl

ngpt/utils/__init__.py

@@ -0,0 +1 @@
+# ngpt utils module

{ngpt-2.8.0.dist-info → ngpt-2.9.1.dist-info}/METADATA

@@ -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.9.1.dist-info/RECORD

@@ -0,0 +1,23 @@
+ngpt/__init__.py,sha256=awvycdj3tgcOr0BO81L4XU6DOtnToxFqkPHe1Pyu0Bw,652
+ngpt/cli.py,sha256=j3eFYPOtCCFBOGh7NK5IWEnADnTMMSEB9GLyIDoW724,66
+ngpt/cli_config.py,sha256=LatikOJTtohbmCfXM6AH44qplbpyAD-x1kMkmaJHRS0,9046
+ngpt/client.py,sha256=Rv-JO8RAmw1v3gdLkwaPe_PEw6p83cejO0YNT_DDjeg,15134
+ngpt/config.py,sha256=WYOk_b1eiYjo6hpV3pfXr2RjqhOnmKqwZwKid1T41I4,10363
+ngpt/cli/__init__.py,sha256=hebbDSMGiOd43YNnQP67uzr67Ue6rZPwm2czynr5iZY,43
+ngpt/cli/config_manager.py,sha256=L091h99ntMBth_FM39npGCOtDCV5kVkukNSkCIj6dpI,3752
+ngpt/cli/formatters.py,sha256=1ofNEWEZtFr0MJ3oWomoL_mFmZHlUdT3I5qGtbDQ4g0,9378
+ngpt/cli/interactive.py,sha256=J6DFkJVBdJ6NjZllsDgJnY1J5RTiKW341p4Zn4wHpGc,11718
+ngpt/cli/main.py,sha256=HBa_FoyU3SOqtRz87qNAefk1CKoiSroYavR9qQMNhv0,30029
+ngpt/cli/renderers.py,sha256=U3Vef3nY1NF2JKtLUtUjdFomyqIrijGWdxRPm46urr4,10546
+ngpt/cli/ui.py,sha256=2JXkCRw5utaKpNZIy0u8F_Jh2zrWbm93dMz91wf9CkQ,5334
+ngpt/cli/modes/__init__.py,sha256=11znFpqzHyRsEtaTrms5M3q2SrscT9VvUgr7C2B1o-E,179
+ngpt/cli/modes/chat.py,sha256=ilTEGu3a8FJ_wGC_P5WnDLx0Okzh3QxJ8HoiYj84g0o,2721
+ngpt/cli/modes/code.py,sha256=_Z3cKYdeifYZSXZ4dMnQWcnVpM2TvYQd-7S7Q3blfEw,3998
+ngpt/cli/modes/shell.py,sha256=Fx83_JBc3P5vgCCPlXgXFSgzwTY0UMGfUwY4_CU10Ro,1654
+ngpt/cli/modes/text.py,sha256=YpNpcujPweO_Biwg4aYwGw4_ShefzaNVtf8d_QrcR_Q,2719
+ngpt/utils/__init__.py,sha256=NK8wlI9-YeaKPOaXBVfUj3mKOXohfD3GmNy5obOIXOM,20
+ngpt-2.9.1.dist-info/METADATA,sha256=2_YMBdFfN_vPlaI5d6ZTsr9MPfq0ldkvTtr2rEfJ-n8,20343
+ngpt-2.9.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+ngpt-2.9.1.dist-info/entry_points.txt,sha256=1cnAMujyy34DlOahrJg19lePSnb08bLbkUs_kVerqdk,39
+ngpt-2.9.1.dist-info/licenses/LICENSE,sha256=mQkpWoADxbHqE0HRefYLJdm7OpdrXBr3vNv5bZ8w72M,1065
+ngpt-2.9.1.dist-info/RECORD,,

ngpt-2.8.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-ngpt/__init__.py,sha256=awvycdj3tgcOr0BO81L4XU6DOtnToxFqkPHe1Pyu0Bw,652
-ngpt/cli.py,sha256=8E65ovaJE0OJ3-M6aw_FqCNSy_1-x1h4NwhnsZOlXq4,81580
-ngpt/cli_config.py,sha256=LatikOJTtohbmCfXM6AH44qplbpyAD-x1kMkmaJHRS0,9046
-ngpt/client.py,sha256=Rv-JO8RAmw1v3gdLkwaPe_PEw6p83cejO0YNT_DDjeg,15134
-ngpt/config.py,sha256=WYOk_b1eiYjo6hpV3pfXr2RjqhOnmKqwZwKid1T41I4,10363
-ngpt-2.8.0.dist-info/METADATA,sha256=g6KOwGut4qU6t1fbpsEaH1FPw6_PSDRRT3kZUGqO2ws,17993
-ngpt-2.8.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-ngpt-2.8.0.dist-info/entry_points.txt,sha256=1cnAMujyy34DlOahrJg19lePSnb08bLbkUs_kVerqdk,39
-ngpt-2.8.0.dist-info/licenses/LICENSE,sha256=mQkpWoADxbHqE0HRefYLJdm7OpdrXBr3vNv5bZ8w72M,1065
-ngpt-2.8.0.dist-info/RECORD,,