z-grc 0.0.14__tar.gz

z_grc-0.0.14/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zeb labs
+
+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.

z_grc-0.0.14/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: z-grc
+Version: 0.0.14
+Summary: Governance Engine by zeb labs
+Author-email: Samrat Damodaran <samrat.damodaran@zeb.co>, Shriyokesh Thangavel <shriyokesh.thangavel@zeb.co>, Sid V <sid@zeb.co>, Madhavsrikrishna Sriram <madhavsrikrishna.sriram@zeb.co>, Noor Shekumohamed <noor.shekumohamed@zeb.co>, Arunachalam Gunasekaran <Arun.Gunasekaran@zeb.co>
+Maintainer-email: Samrat Damodaran <samrat.damodaran@zeb.co>, Shriyokesh Thangavel <shriyokesh.thangavel@zeb.co>, Sid V <sid@zeb.co>, Madhavsrikrishna Sriram <madhavsrikrishna.sriram@zeb.co>, Noor Shekumohamed <noor.shekumohamed@zeb.co>, Arunachalam Gunasekaran <Arun.Gunasekaran@zeb.co>
+License: MIT License
+        
+        Copyright (c) 2026 zeb labs
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/zeb-ai/z-grc
+Project-URL: Repository, https://github.com/zeb-ai/z-grc
+Keywords: governance,llm,quota,policy,telemetry,observability
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: mitmproxy>=12.2.1
+Requires-Dist: opentelemetry-api>=1.39.1
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.39.1
+Requires-Dist: opentelemetry-instrumentation>=0.60b1
+Requires-Dist: opentelemetry-instrumentation-httpx>=0.60b1
+Requires-Dist: opentelemetry-instrumentation-threading>=0.60b1
+Requires-Dist: opentelemetry-sdk>=1.39.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: rich>=14.3.3
+Requires-Dist: tenacity>=9.1.4
+Dynamic: license-file
+
+# Z-GRC - Z Governance, Risk, Control Engine
+
+[![Python Version](https://img.shields.io/badge/python-3.14+-blue.svg)](https://www.python.org/downloads/)
+[![Code Style: Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+[![PyPI version](https://badge.fury.io/py/z-grc.svg)](https://pypi.org/project/z-grc/)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/z-grc)](https://pypi.org/project/z-grc/)
+
+[//]: # ([![License]&#40;https://img.shields.io/badge/license-Proprietary-red.svg&#41;]&#40;&#41;)
+
+Enterprise-grade governance engine for Large Language Model applications. Provides automatic interception, policy enforcement, quota management, and comprehensive observability across multiple LLM providers with zero code changes.
+
+## Installation
+
+```bash
+uv add z-grc
+```
+
+Or with auto-instrumentation:
+
+```bash
+uv add z-grc[auto-instrument]
+```
+
+## Quick Start
+
+```python
+import zgrc
+import boto3
+import json
+
+# Initialize GRC
+zgrc.init(api_key="your-zgrc-api-key")
+
+# Use your LLM SDK normally - GRC handles everything
+client = boto3.client("bedrock-runtime", region_name="us-east-1")
+
+response = client.invoke_model(
+    modelId="us.anthropic.claude-sonnet-4-5-20250929-v1:0",
+    body=json.dumps({
+        "anthropic_version": "bedrock-2023-05-31",
+        "max_tokens": 1024,
+        "messages": [{"role": "user", "content": "Hello!"}]
+    })
+)
+
+# Z-GRC automatically:
+# - Validates quota before requests
+# - Tracks token usage
+# - Enforces policies
+# - Sends telemetry (traces, metrics, logs)
+```
+
+## Features
+
+### Zero-Code Integration
+Drop-in solution requiring only `zgrc.init()`. Works with existing code without modifications.
+
+### Auto-Discovery
+Automatically detects and intercepts installed LLM SDKs:
+- AWS Bedrock (boto3)
+- Anthropic (coming soon)
+- OpenAI (coming soon)
+- Azure OpenAI (coming soon)
+
+### Policy Enforcement
+Real-time quota validation and token limit enforcement. Blocks requests when quota is exceeded.
+
+```python
+from zgrc.utils import QuotaExceededException
+
+try:
+    response = client.invoke_model(...)
+except QuotaExceededException as e:
+    print(f"Quota exceeded: {e.used}/{e.limit} tokens")
+```
+
+### Auto-Instrumentation
+Optional automatic instrumentation for HTTP clients, web frameworks, databases, and more:
+
+```python
+zgrc.init(
+    api_key="your-zgrc-api-key",
+    auto_instrument=True,
+    app_name="my-app",
+    environment="production"
+)
+```
+
+### Framework Agnostic
+Works with vanilla SDKs and popular frameworks:
+
+```python
+# PydanticAI
+from pydantic_ai import Agent
+agent = Agent("bedrock")
+result = await agent.run("Your prompt")
+
+# LangChain
+from langchain_aws import ChatBedrock
+llm = ChatBedrock(model_id="...")
+response = llm.invoke("Your prompt")
+
+# Strands Agents
+from strands_agents import Agent
+agent = Agent(provider="bedrock")
+response = agent.execute("Your prompt")
+```
+
+### Streaming Support
+Fully supports streaming responses with automatic token tracking:
+
+```python
+response = client.converse_stream(
+    modelId="...",
+    messages=[{"role": "user", "content": [{"text": "Tell me a story"}]}]
+)
+
+for event in response["stream"]:
+    if "contentBlockDelta" in event:
+        print(event["contentBlockDelta"]["delta"]["text"], end="")
+```
+
+## Configuration
+
+```python
+zgrc.init(
+    api_key: str,                  # Your Z-GRC API key (required)
+    auto_instrument: bool = False, # Enable auto-instrumentation
+    app_name: str = None,          # Application name for telemetry
+    environment: str = None,       # Environment (dev/staging/prod)
+    log_level: int = logging.ERROR # Z-GRC internal log level
+)
+```
+
+## Building Executables
+
+Build standalone executables with PyInstaller:
+
+### macOS/Linux
+```bash
+./build.sh
+```
+Output: `dist/z-grc-proxy-macos-arm64` or `dist/z-grc-proxy-linux-x86_64`
+
+### Windows
+```bash
+build.bat
+```
+Output: `dist/z-grc-proxy-windows-x64.exe`
+
+### Test Executable
+```bash
+# macOS/Linux
+./dist/z-grc-proxy-macos-arm64 --api-key=zgrc_xxx
+
+# Windows
+dist\z-grc-proxy-windows-x64.exe --api-key=zgrc_xxx
+```
+
+**Note:** Certificates auto-generate in `~/.mitmproxy/` on first run. Users must set `HTTPS_PROXY` and `NODE_EXTRA_CA_CERTS` environment variables.
+
+## Installing Executor
+
+### macOS / Linux
+```bash
+curl -fsSL https://raw.githubusercontent.com/zeb-ai/z-grc/main/install.sh | bash
+```
+
+### Windows (PowerShell)
+```powershell
+irm https://raw.githubusercontent.com/zeb-ai/z-grc/main/install.ps1 | iex
+```

z_grc-0.0.14/README.md

@@ -0,0 +1,172 @@
+# Z-GRC - Z Governance, Risk, Control Engine
+
+[![Python Version](https://img.shields.io/badge/python-3.14+-blue.svg)](https://www.python.org/downloads/)
+[![Code Style: Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+[![PyPI version](https://badge.fury.io/py/z-grc.svg)](https://pypi.org/project/z-grc/)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/z-grc)](https://pypi.org/project/z-grc/)
+
+[//]: # ([![License](https://img.shields.io/badge/license-Proprietary-red.svg)]())
+
+Enterprise-grade governance engine for Large Language Model applications. Provides automatic interception, policy enforcement, quota management, and comprehensive observability across multiple LLM providers with zero code changes.
+
+## Installation
+
+```bash
+uv add z-grc
+```
+
+Or with auto-instrumentation:
+
+```bash
+uv add z-grc[auto-instrument]
+```
+
+## Quick Start
+
+```python
+import zgrc
+import boto3
+import json
+
+# Initialize GRC
+zgrc.init(api_key="your-zgrc-api-key")
+
+# Use your LLM SDK normally - GRC handles everything
+client = boto3.client("bedrock-runtime", region_name="us-east-1")
+
+response = client.invoke_model(
+    modelId="us.anthropic.claude-sonnet-4-5-20250929-v1:0",
+    body=json.dumps({
+        "anthropic_version": "bedrock-2023-05-31",
+        "max_tokens": 1024,
+        "messages": [{"role": "user", "content": "Hello!"}]
+    })
+)
+
+# Z-GRC automatically:
+# - Validates quota before requests
+# - Tracks token usage
+# - Enforces policies
+# - Sends telemetry (traces, metrics, logs)
+```
+
+## Features
+
+### Zero-Code Integration
+Drop-in solution requiring only `zgrc.init()`. Works with existing code without modifications.
+
+### Auto-Discovery
+Automatically detects and intercepts installed LLM SDKs:
+- AWS Bedrock (boto3)
+- Anthropic (coming soon)
+- OpenAI (coming soon)
+- Azure OpenAI (coming soon)
+
+### Policy Enforcement
+Real-time quota validation and token limit enforcement. Blocks requests when quota is exceeded.
+
+```python
+from zgrc.utils import QuotaExceededException
+
+try:
+    response = client.invoke_model(...)
+except QuotaExceededException as e:
+    print(f"Quota exceeded: {e.used}/{e.limit} tokens")
+```
+
+### Auto-Instrumentation
+Optional automatic instrumentation for HTTP clients, web frameworks, databases, and more:
+
+```python
+zgrc.init(
+    api_key="your-zgrc-api-key",
+    auto_instrument=True,
+    app_name="my-app",
+    environment="production"
+)
+```
+
+### Framework Agnostic
+Works with vanilla SDKs and popular frameworks:
+
+```python
+# PydanticAI
+from pydantic_ai import Agent
+agent = Agent("bedrock")
+result = await agent.run("Your prompt")
+
+# LangChain
+from langchain_aws import ChatBedrock
+llm = ChatBedrock(model_id="...")
+response = llm.invoke("Your prompt")
+
+# Strands Agents
+from strands_agents import Agent
+agent = Agent(provider="bedrock")
+response = agent.execute("Your prompt")
+```
+
+### Streaming Support
+Fully supports streaming responses with automatic token tracking:
+
+```python
+response = client.converse_stream(
+    modelId="...",
+    messages=[{"role": "user", "content": [{"text": "Tell me a story"}]}]
+)
+
+for event in response["stream"]:
+    if "contentBlockDelta" in event:
+        print(event["contentBlockDelta"]["delta"]["text"], end="")
+```
+
+## Configuration
+
+```python
+zgrc.init(
+    api_key: str,                  # Your Z-GRC API key (required)
+    auto_instrument: bool = False, # Enable auto-instrumentation
+    app_name: str = None,          # Application name for telemetry
+    environment: str = None,       # Environment (dev/staging/prod)
+    log_level: int = logging.ERROR # Z-GRC internal log level
+)
+```
+
+## Building Executables
+
+Build standalone executables with PyInstaller:
+
+### macOS/Linux
+```bash
+./build.sh
+```
+Output: `dist/z-grc-proxy-macos-arm64` or `dist/z-grc-proxy-linux-x86_64`
+
+### Windows
+```bash
+build.bat
+```
+Output: `dist/z-grc-proxy-windows-x64.exe`
+
+### Test Executable
+```bash
+# macOS/Linux
+./dist/z-grc-proxy-macos-arm64 --api-key=zgrc_xxx
+
+# Windows
+dist\z-grc-proxy-windows-x64.exe --api-key=zgrc_xxx
+```
+
+**Note:** Certificates auto-generate in `~/.mitmproxy/` on first run. Users must set `HTTPS_PROXY` and `NODE_EXTRA_CA_CERTS` environment variables.
+
+## Installing Executor
+
+### macOS / Linux
+```bash
+curl -fsSL https://raw.githubusercontent.com/zeb-ai/z-grc/main/install.sh | bash
+```
+
+### Windows (PowerShell)
+```powershell
+irm https://raw.githubusercontent.com/zeb-ai/z-grc/main/install.ps1 | iex
+```

z_grc-0.0.14/pyproject.toml

@@ -0,0 +1,90 @@
+[project]
+name = "z-grc"
+version = "0.0.14"
+description = "Governance Engine by zeb labs"
+readme = "README.md"
+requires-python = ">=3.13"
+license = { file = "LICENSE" }
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: System :: Monitoring",
+]
+authors = [
+    { name = "Samrat Damodaran", email = "samrat.damodaran@zeb.co" },
+    { name = "Shriyokesh Thangavel", email = "shriyokesh.thangavel@zeb.co" },
+    { name = "Sid V", email = "sid@zeb.co" },
+    { name = "Madhavsrikrishna Sriram", email = "madhavsrikrishna.sriram@zeb.co" },
+    { name = "Noor Shekumohamed", email = "noor.shekumohamed@zeb.co" },
+    { name = "Arunachalam Gunasekaran", email = "Arun.Gunasekaran@zeb.co" }
+]
+maintainers = [
+    { name = "Samrat Damodaran", email = "samrat.damodaran@zeb.co" },
+    { name = "Shriyokesh Thangavel", email = "shriyokesh.thangavel@zeb.co" },
+    { name = "Sid V", email = "sid@zeb.co" },
+    { name = "Madhavsrikrishna Sriram", email = "madhavsrikrishna.sriram@zeb.co" },
+    { name = "Noor Shekumohamed", email = "noor.shekumohamed@zeb.co" },
+    { name = "Arunachalam Gunasekaran", email = "Arun.Gunasekaran@zeb.co" },]
+keywords = ["governance", "llm", "quota", "policy", "telemetry", "observability"]
+dependencies = [
+    "httpx>=0.28.1",
+    "mitmproxy>=12.2.1",
+    "opentelemetry-api>=1.39.1",
+    "opentelemetry-exporter-otlp-proto-http>=1.39.1",
+    "opentelemetry-instrumentation>=0.60b1",
+    "opentelemetry-instrumentation-httpx>=0.60b1",
+    "opentelemetry-instrumentation-threading>=0.60b1",
+    "opentelemetry-sdk>=1.39.1",
+    "pydantic>=2.12.5",
+    "rich>=14.3.3",
+    "tenacity>=9.1.4",
+]
+
+[project.urls]
+Homepage = "https://github.com/zeb-ai/z-grc"
+Repository = "https://github.com/zeb-ai/z-grc"
+
+
+# DEV dependency only for running example codes and precommit
+[dependency-groups]
+dev = [
+    "ruff>=0.15.6",
+    "boto3>=1.42.70",
+    "pydantic-ai>=1.70.0",
+    "strands-agents>=1.30.0",
+    "strands-agents-tools>=0.2.22",
+    "pre-commit>=4.5.1",
+    "pyinstaller>=6.19.0",
+    "build>=1.4.3",
+    "twine>=6.2.0",
+]
+
+# install when instrumentation needed for whole project/application
+auto-instrument = [
+    "opentelemetry-instrumentation-fastapi>=0.49b0,<0.61b0",
+    "opentelemetry-instrumentation-flask>=0.49b0,<0.61b0",
+    "opentelemetry-instrumentation-starlette>=0.49b0,<0.61b0",
+
+    "opentelemetry-instrumentation-requests>=0.49b0,<0.61b0",
+    "opentelemetry-instrumentation-aiohttp-client>=0.49b0,<0.61b0",
+    "opentelemetry-instrumentation-urllib3>=0.49b0,<0.61b0",
+
+    "opentelemetry-instrumentation-psycopg2>=0.49b0,<0.61b0",
+    "opentelemetry-instrumentation-psycopg>=0.49b0,<0.61b0",
+    "opentelemetry-instrumentation-sqlalchemy>=0.49b0,<0.61b0",
+    "opentelemetry-instrumentation-redis>=0.49b0,<0.61b0",
+    "opentelemetry-instrumentation-pymongo>=0.49b0,<0.61b0",
+
+    "opentelemetry-instrumentation-botocore>=0.49b0,<0.61b0",
+    "opentelemetry-instrumentation-boto3sqs>=0.49b0,<0.61b0",
+
+    "opentelemetry-instrumentation-celery>=0.49b0,<0.61b0",
+
+    "opentelemetry-instrumentation-logging>=0.49b0,<0.61b0",
+    "opentelemetry-instrumentation-system-metrics>=0.49b0,<0.61b0",
+]
+
+[project.scripts]
+grc-proxy = "grc.proxy.main:main"

z_grc-0.0.14/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+