ccs-llmconnector 1.0.0__py3-none-any.whl → 1.0.1__py3-none-any.whl

{ccs_llmconnector-1.0.0.dist-info → ccs_llmconnector-1.0.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ccs_llmconnector
-Version: 1.0.0
+Version: 1.0.1
 Summary: Lightweight wrapper around different LLM provider Python SDK Responses APIs.
 Author: CCS
 License: MIT
@@ -14,18 +14,22 @@ Requires-Dist: anthropic
 Requires-Dist: xai-sdk
 Dynamic: license-file
 
-# llmconnector
+# ccs_llmconnector
 
-`llmconnector` is a thin Python wrapper around leading large-language-model SDKs,
-including the OpenAI Responses API, Google's Gemini SDK, and Anthropic's Claude
-Messages API. It exposes a minimal interface that forwards the most common
-options such as API key, prompt, optional reasoning effort hints, token limits,
-and image inputs, and it includes helpers to enumerate the models available to
-your account with each provider.
+`ccs-llmconnector` is a thin Python wrapper around leading large-language-model SDKs,
+including the OpenAI Responses API, Google's Gemini SDK, Anthropic's Claude
+Messages API, and xAI's Grok chat API. It exposes a minimal interface that
+forwards the most common options such as API key, prompt, optional reasoning
+effort hints, token limits, and image inputs, and includes helpers to enumerate
+the models available to your account with each provider.
 
 ## Installation
 
 ```bash
+# from PyPI (normalized project name)
+pip install ccs-llmconnector
+
+# or from source (this repository)
 pip install .
 ```
 
@@ -34,6 +38,7 @@ pip install .
 - `openai` (installed automatically with the package)
 - `google-genai` (installed automatically with the package)
 - `anthropic` (installed automatically with the package)
+- `xai-sdk` (installed automatically with the package; requires Python 3.10+)
 
 ## Components
 
@@ -166,7 +171,8 @@ for model in client.list_models(api_key="sk-ant-api-key"):
 
 Use the `GrokClient` when you want direct access to xAI's Grok chat API.
 
-> Requires the `xai-sdk` Python package (install manually with `pip install xai-sdk`). The SDK targets Python 3.10 and newer.
+> Requires the `xai-sdk` Python package (installed automatically with `llmconnector`).
+> Note: `xai-sdk` targets Python 3.10 and newer.
 
 ```python
 from llmconnector import GrokClient
@@ -278,7 +284,7 @@ for model in client.list_models(api_key="sk-your-api-key"):
 
 ### Usage
 
-`LLMClient` routes requests to whichever provider has been registered; OpenAI, Gemini, and Anthropic are configured by default when their dependencies are available. The client also exposes `list_models` to surface the identifiers available for the selected provider.
+`LLMClient` routes requests to whichever provider has been registered; OpenAI, Gemini, Anthropic, and Grok (alias: `xai`) are configured by default when their dependencies are available. The client also exposes `list_models` to surface the identifiers available for the selected provider.
 
 ```python
 from llmconnector import LLMClient
@@ -328,7 +334,7 @@ for model in llm_client.list_models(provider="openai", api_key="sk-your-api-key"
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| `provider` | `str` | Yes | Registered provider key (default registry includes `'openai'`, `'gemini'`, and `'anthropic'`). |
+| `provider` | `str` | Yes | Registered provider key (default registry includes `'openai'`, `'gemini'`, `'anthropic'`, `'grok'`/`'xai'`). |
 | `api_key` | `str` | Yes | Provider-specific API key. |
 | `prompt` | `Optional[str]` | Conditional | Plain-text prompt. Required unless `images` is supplied. |
 | `model` | `str` | Yes | Provider-specific model identifier. |
@@ -339,6 +345,34 @@ for model in llm_client.list_models(provider="openai", api_key="sk-your-api-key"
 Use `LLMClient.register_provider(name, client)` to add additional providers that implement
 `generate_response` with the same signature.
 
+## CLI
+
+The package provides a simple CLI entry point named `client_cli` (see `pyproject.toml`).
+It reads API keys from environment variables and supports generating responses and
+listing models.
+
+- API key environment variables:
+  - OpenAI: `OPENAI_API_KEY`
+  - Gemini: `GEMINI_API_KEY` (fallback: `GOOGLE_API_KEY`)
+  - Anthropic: `ANTHROPIC_API_KEY`
+  - Grok/xAI: `GROK_API_KEY` or `XAI_API_KEY` (either works)
+
+Examples:
+
+```bash
+# Generate a response
+client_cli respond --provider openai --model gpt-4o --prompt "Hello!"
+
+# List models for one provider (human-readable)
+client_cli models --provider gemini
+
+# List models for one provider (JSON)
+client_cli models --provider anthropic --json
+
+# List models for all registered providers
+client_cli all-models
+```
+
 ## Development
 
 The project uses a standard `pyproject.toml` based packaging layout with sources
@@ -347,3 +381,5 @@ stored under `src/`. Install the project in editable mode and run your preferred
 ```bash
 pip install -e .
 ```
+
+Requires Python 3.8+.

{ccs_llmconnector-1.0.0.dist-info → ccs_llmconnector-1.0.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-ccs_llmconnector-1.0.0.dist-info/licenses/LICENSE,sha256=YYl_gt0O2aJW046pklgKWlVVZZpFcTIOsycrs69ltn4,1061
+ccs_llmconnector-1.0.1.dist-info/licenses/LICENSE,sha256=YYl_gt0O2aJW046pklgKWlVVZZpFcTIOsycrs69ltn4,1061
 llmconnector/__init__.py,sha256=SCCVGnaj8aFeE5ugvgf2bGmCLt29R__hoRu0qKhJA4c,1174
 llmconnector/anthropic_client.py,sha256=v-BEEZQFEY5GunbzSnZLy0dSAmMqaegc2u86WPvCLOE,6196
 llmconnector/client.py,sha256=SVn-afiwjdnFnlDflN-WiGK1wdFyazh5wSmUTtRWQmU,4834
@@ -7,8 +7,8 @@ llmconnector/gemini_client.py,sha256=OoLI9Svk0XTXqPDFsY6u4cdiVQV7t3AOGN_yIBGiMIg
 llmconnector/grok_client.py,sha256=ZLDIkb17ayLYxWxs0KZYbpR_PD1Ocze0fAmUXxouS0k,4678
 llmconnector/openai_client.py,sha256=3FTOq-M0IP3n9Q48P9JDCT46wP79OAVW4klAhFeuT2g,4717
 llmconnector/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-ccs_llmconnector-1.0.0.dist-info/METADATA,sha256=ISFsQ5DAfL7sGhFGwtHUMeSKh2lClQH5U8NcZBXDo4k,12974
-ccs_llmconnector-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ccs_llmconnector-1.0.0.dist-info/entry_points.txt,sha256=eFvLY3nHAG_QhaKlemhhK7echfezW0KiMdSNMZOStLc,60
-ccs_llmconnector-1.0.0.dist-info/top_level.txt,sha256=Doer7TAUsN8UXQfPHPNsuBXVNCz2uV-Q0v4t4fwv_MM,13
-ccs_llmconnector-1.0.0.dist-info/RECORD,,
+ccs_llmconnector-1.0.1.dist-info/METADATA,sha256=wS-rlHw69DoFF_Wpwj8zqZxwuSGDpe-uhEkGV5esZCo,14051
+ccs_llmconnector-1.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ccs_llmconnector-1.0.1.dist-info/entry_points.txt,sha256=eFvLY3nHAG_QhaKlemhhK7echfezW0KiMdSNMZOStLc,60
+ccs_llmconnector-1.0.1.dist-info/top_level.txt,sha256=Doer7TAUsN8UXQfPHPNsuBXVNCz2uV-Q0v4t4fwv_MM,13
+ccs_llmconnector-1.0.1.dist-info/RECORD,,