overmind 0.1.19__tar.gz

overmind-0.1.19/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Overmind Python Client
+
+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. 

overmind-0.1.19/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: overmind
+Version: 0.1.19
+Summary: Python client for Overmind API
+License-File: LICENSE
+Keywords: overmind,ai,api,client,policy,enforcement
+Author: Overmind Ltd
+Requires-Python: >=3.10,<4
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Provides-Extra: full
+Requires-Dist: langgraph (>=1.0.7)
+Requires-Dist: opentelemetry-api (>=1.35.0,<2.0.0)
+Requires-Dist: opentelemetry-exporter-otlp-proto-http (>=1.35.0,<2.0.0)
+Requires-Dist: opentelemetry-instrumentation (>=0.60b1)
+Requires-Dist: opentelemetry-instrumentation-fastapi (>=0.60b1,<0.61)
+Requires-Dist: opentelemetry-instrumentation-httpx (>=0.60b1,<0.61) ; extra == "full"
+Requires-Dist: opentelemetry-instrumentation-logging (>=0.60b1,<0.61) ; extra == "full"
+Requires-Dist: opentelemetry-instrumentation-requests (>=0.60b1,<0.61) ; extra == "full"
+Requires-Dist: opentelemetry-sdk (>=1.35.0,<2.0.0)
+Requires-Dist: opentelemetry-semantic-conventions (>=0.60b1)
+Requires-Dist: opentelemetry-semantic-conventions-ai (>=0.4.13,<0.5.0)
+Requires-Dist: packaging (>=23.0,<24.0)
+Requires-Dist: pydantic (>=2.0.0,<3.0.0)
+Requires-Dist: requests (>=2.31.0,<3.0.0)
+Requires-Dist: rich (>=14.0.0,<15.0.0)
+Requires-Dist: typing-extensions (>=4.0.0,<5.0.0)
+Requires-Dist: wrapt (>=1.14.0,<2.0.0)
+Project-URL: Homepage, https://github.com/overmind-core/overmind-python
+Project-URL: Repository, https://github.com/overmind-core/overmind-python
+Description-Content-Type: text/markdown
+
+# Overmind Client
+
+[![CI Checks](https://github.com/overmind-core/overmind-python/actions/workflows/publish.yml/badge.svg)](https://github.com/overmind-core/overmind-python/actions/workflows/publish.yml)
+[![PyPI version](https://img.shields.io/pypi/v/overmind.svg)](https://pypi.org/project/overmind/)
+
+A client for the Overmind API that provides easy access to AI provider endpoints with policy enforcement.
+
+## Features
+
+- **Easy Integration**: Use major providers like OpenAI with the same call signatures
+- **Policy Enforcement**: Apply customizable policies to your LLM inputs and outputs
+- **Observability**: Log and explore all LLM calls and policy results
+
+## Installation
+
+
+
+```bash
+pip install overmind
+```
+
+
+## Quick Start
+
+### Use Overmind Proxy
+
+Get your free Overmind API key at [console.overmindlab.ai](https://console.overmindlab.ai)
+
+Below we initialise the Overmind client and call GPT-5-mini with `anonymize_pii` and `reject_irrelevant_answer` policies. This will prevent PII data leakage and ensure only relevant answers are produced.
+```python
+import os
+from overmind.client import OvermindClient
+
+# Set env variables (or pass directly to the client)
+# Get your free overmind API key at console.overmindlab.ai
+os.environ["OVERMIND_API_KEY"] = "your_overmind_api_key"
+os.environ["OPENAI_API_KEY"] = "your_openai_api_key"
+
+overmind = OvermindClient()
+
+
+# Use existing OpenAI client methods
+response = overmind.openai.responses.create(
+    model='gpt-5-mini',
+    input="Should I switch my mortgage now or wait for a year to have a lower interest rate?",
+    # Overmind built-in policies
+    input_policies=['anonymize_pii'],
+    output_policies=['reject_irrelevant_answer'],
+)
+
+response.summary()
+```
+
+
+
+### Define your own policies
+There are different policy templates that can be set up at invocation time.
+```python
+
+# Define input policy to filter out PII
+input_pii_policy = {
+    'policy_template': 'anonymize_pii',
+    'parameters': {
+        'pii_types': ['DEMOGRAPHIC_DATA', 'FINANCIAL_ID']
+    }
+}
+
+# Define output policy to check response against criteria
+output_llm_judge_criteria = {
+    'policy_template': 'reject_llm_judge_with_criteria',
+    'parameters': {
+        'criteria': [
+            "Must not be a financial advice",
+            "Must answer the question fully",
+        ]
+    }
+}
+
+input_messages = [
+    {
+        "role": "user", 
+        "content": "Hi my name is Jon, account number 20194812. Should I switch my mortgage now or wait for a year to have a lower interest rate?"
+    }
+]
+
+result = overmind.openai.responses.create(
+    model='gpt-5-mini',
+    input=input_messages,
+    input_policies=[input_pii_policy],
+    output_policies=[output_llm_judge_criteria]
+)
+
+result.summary()
+```
+### Use Overmind Layers
+
+For more complex use cases you can choose Overmind Layers - an API to call standalone policies without relying on us to call LLMs. 
+
+This use case is best demonstrated in our [LangGraph integration tutorial](https://github.com/overmind-core/overmind-python/blob/main/docs/Overmind%20Layers%20%26%20LangGraph%20tutorial.ipynb), although the Layers can be used with any framework.
+
+## Further usage
+
+There are a more detailed tutorials available for [Overmind Proxy](https://github.com/overmind-core/overmind-python/blob/main/docs/Overmind%20Proxy%20tutorial.ipynb) and [Overmind Layers & LangGraph integration](https://github.com/overmind-core/overmind-python/blob/main/docs/Overmind%20Layers%20%26%20LangGraph%20tutorial.ipynb).
+
+We are not storing your API keys and you are solely responsible for managing them and the associated costs.
+
+On our side we run policy executions for free as this is an alpha stage product. We may impose usage limits and scale our services up and down from time to time.
+
+We appreciate any feedback, collaboration or other suggestions. You can reach out at [support@evallab.dev](mailto:support@evallab.dev)

overmind-0.1.19/README.md

@@ -0,0 +1,109 @@
+# Overmind Client
+
+[![CI Checks](https://github.com/overmind-core/overmind-python/actions/workflows/publish.yml/badge.svg)](https://github.com/overmind-core/overmind-python/actions/workflows/publish.yml)
+[![PyPI version](https://img.shields.io/pypi/v/overmind.svg)](https://pypi.org/project/overmind/)
+
+A client for the Overmind API that provides easy access to AI provider endpoints with policy enforcement.
+
+## Features
+
+- **Easy Integration**: Use major providers like OpenAI with the same call signatures
+- **Policy Enforcement**: Apply customizable policies to your LLM inputs and outputs
+- **Observability**: Log and explore all LLM calls and policy results
+
+## Installation
+
+
+
+```bash
+pip install overmind
+```
+
+
+## Quick Start
+
+### Use Overmind Proxy
+
+Get your free Overmind API key at [console.overmindlab.ai](https://console.overmindlab.ai)
+
+Below we initialise the Overmind client and call GPT-5-mini with `anonymize_pii` and `reject_irrelevant_answer` policies. This will prevent PII data leakage and ensure only relevant answers are produced.
+```python
+import os
+from overmind.client import OvermindClient
+
+# Set env variables (or pass directly to the client)
+# Get your free overmind API key at console.overmindlab.ai
+os.environ["OVERMIND_API_KEY"] = "your_overmind_api_key"
+os.environ["OPENAI_API_KEY"] = "your_openai_api_key"
+
+overmind = OvermindClient()
+
+
+# Use existing OpenAI client methods
+response = overmind.openai.responses.create(
+    model='gpt-5-mini',
+    input="Should I switch my mortgage now or wait for a year to have a lower interest rate?",
+    # Overmind built-in policies
+    input_policies=['anonymize_pii'],
+    output_policies=['reject_irrelevant_answer'],
+)
+
+response.summary()
+```
+
+
+
+### Define your own policies
+There are different policy templates that can be set up at invocation time.
+```python
+
+# Define input policy to filter out PII
+input_pii_policy = {
+    'policy_template': 'anonymize_pii',
+    'parameters': {
+        'pii_types': ['DEMOGRAPHIC_DATA', 'FINANCIAL_ID']
+    }
+}
+
+# Define output policy to check response against criteria
+output_llm_judge_criteria = {
+    'policy_template': 'reject_llm_judge_with_criteria',
+    'parameters': {
+        'criteria': [
+            "Must not be a financial advice",
+            "Must answer the question fully",
+        ]
+    }
+}
+
+input_messages = [
+    {
+        "role": "user", 
+        "content": "Hi my name is Jon, account number 20194812. Should I switch my mortgage now or wait for a year to have a lower interest rate?"
+    }
+]
+
+result = overmind.openai.responses.create(
+    model='gpt-5-mini',
+    input=input_messages,
+    input_policies=[input_pii_policy],
+    output_policies=[output_llm_judge_criteria]
+)
+
+result.summary()
+```
+### Use Overmind Layers
+
+For more complex use cases you can choose Overmind Layers - an API to call standalone policies without relying on us to call LLMs. 
+
+This use case is best demonstrated in our [LangGraph integration tutorial](https://github.com/overmind-core/overmind-python/blob/main/docs/Overmind%20Layers%20%26%20LangGraph%20tutorial.ipynb), although the Layers can be used with any framework.
+
+## Further usage
+
+There are a more detailed tutorials available for [Overmind Proxy](https://github.com/overmind-core/overmind-python/blob/main/docs/Overmind%20Proxy%20tutorial.ipynb) and [Overmind Layers & LangGraph integration](https://github.com/overmind-core/overmind-python/blob/main/docs/Overmind%20Layers%20%26%20LangGraph%20tutorial.ipynb).
+
+We are not storing your API keys and you are solely responsible for managing them and the associated costs.
+
+On our side we run policy executions for free as this is an alpha stage product. We may impose usage limits and scale our services up and down from time to time.
+
+We appreciate any feedback, collaboration or other suggestions. You can reach out at [support@evallab.dev](mailto:support@evallab.dev)

overmind-0.1.19/overmind/__init__.py

@@ -0,0 +1,23 @@
+"""
+Overmind Python Client
+
+A Python client for the Overmind API that provides easy access to AI provider endpoints
+with policy enforcement and automatic observability.
+"""
+
+from .client import OvermindClient
+from .exceptions import OvermindAPIError, OvermindAuthenticationError, OvermindError
+from .overmind_sdk import init, get_tracer, set_user, set_tag, capture_exception
+
+__version__ = "0.1.0"
+__all__ = [
+    "OvermindClient",
+    "OvermindError",
+    "OvermindAPIError",
+    "OvermindAuthenticationError",
+    "init",
+    "get_tracer",
+    "set_user",
+    "set_tag",
+    "capture_exception",
+]

overmind-0.1.19/overmind/_vendor/__init__.py

@@ -0,0 +1 @@
+# Vendored packages for overmind

overmind-0.1.19/overmind/_vendor/opentelemetry_instrumentation_openai/__init__.py

@@ -0,0 +1,54 @@
+from typing import Callable, Collection, Optional
+
+from opentelemetry.instrumentation.instrumentor import BaseInstrumentor
+from .shared.config import Config
+from .utils import is_openai_v1
+from typing_extensions import Coroutine
+
+_instruments = ("openai >= 0.27.0",)
+
+
+class OpenAIInstrumentor(BaseInstrumentor):
+    """An instrumentor for OpenAI's client library."""
+
+    def __init__(
+        self,
+        enrich_assistant: bool = False,
+        exception_logger=None,
+        get_common_metrics_attributes: Callable[[], dict] = lambda: {},
+        upload_base64_image: Optional[
+            Callable[[str, str, str, str], Coroutine[None, None, str]]
+        ] = lambda *args: "",
+        enable_trace_context_propagation: bool = True,
+        use_legacy_attributes: bool = True,
+    ):
+        super().__init__()
+        Config.enrich_assistant = enrich_assistant
+        Config.exception_logger = exception_logger
+        Config.get_common_metrics_attributes = get_common_metrics_attributes
+        Config.upload_base64_image = upload_base64_image
+        Config.enable_trace_context_propagation = enable_trace_context_propagation
+        Config.use_legacy_attributes = use_legacy_attributes
+
+    def instrumentation_dependencies(self) -> Collection[str]:
+        return _instruments
+
+    def _instrument(self, **kwargs):
+        if is_openai_v1():
+            from .v1 import OpenAIV1Instrumentor
+
+            OpenAIV1Instrumentor().instrument(**kwargs)
+        else:
+            from .v0 import OpenAIV0Instrumentor
+
+            OpenAIV0Instrumentor().instrument(**kwargs)
+
+    def _uninstrument(self, **kwargs):
+        if is_openai_v1():
+            from .v1 import OpenAIV1Instrumentor
+
+            OpenAIV1Instrumentor().uninstrument(**kwargs)
+        else:
+            from .v0 import OpenAIV0Instrumentor
+
+            OpenAIV0Instrumentor().uninstrument(**kwargs)