proxyml 0.1.0__py3-none-any.whl

proxyml/__init__.py

@@ -0,0 +1,27 @@
+from proxyml.client import (
+    put_schema,
+    synthesize_data,
+    train_surrogate,
+    predict,
+    find_counterfactual,
+    interpret_counterfactual,
+)
+from proxyml.schema import (
+    get_schema,
+    gen_continuous_schema,
+    gen_categorical_schema,
+    gen_discrete_schema,
+)
+
+__all__ = [
+    "put_schema",
+    "synthesize_data",
+    "train_surrogate",
+    "predict",
+    "find_counterfactual",
+    "interpret_counterfactual",
+    "get_schema",
+    "gen_continuous_schema",
+    "gen_categorical_schema",
+    "gen_discrete_schema",
+]

proxyml/client.py

@@ -0,0 +1,190 @@
+import logging
+logger = logging.getLogger(__name__)
+
+import requests
+import os
+import numpy as np
+import pandas as pd
+from pandas.api.types import is_float_dtype, is_integer_dtype
+
+
+PROXYML_BASE_URL = os.getenv("PROXYML_BASE_URL", "https://api.proxyml.ai/api/v1")
+
+_BOOL_STRINGS = {"true", "false"}
+
+
+def _headers() -> dict:
+    api_key = os.getenv("PROXYML_API_KEY", "")
+    if not api_key:
+        raise EnvironmentError(
+            "PROXYML_API_KEY is not set. "
+            "Set the environment variable before using the SDK."
+        )
+    return {
+        'Content-Type': 'application/json',
+        'X-API-KEY': api_key,
+    }
+
+
+def post(endpoint: str, payload: dict) -> requests.models.Response:
+    r = requests.post(
+        url=f'{PROXYML_BASE_URL}{endpoint}',
+        json=payload,
+        headers=_headers()
+    )
+    return r
+
+
+def put(endpoint: str, payload: dict) -> requests.models.Response:
+    r = requests.put(
+        url=f'{PROXYML_BASE_URL}{endpoint}',
+        json=payload,
+        headers=_headers()
+    )
+    return r
+
+
+def put_schema(schema: dict):
+    r = put(endpoint='/schema', payload=schema)
+    if r.status_code == 200:
+        logger.info("Schema uploaded successfully")
+        return r.json()
+    logger.error(
+        "Schema upload failed with status %s: %s",
+        r.status_code,
+        r.text
+    )
+    return None
+
+
+def _cast_column(series: pd.Series, ftype: str) -> pd.Series:                                                                                                                         
+    if ftype in ("continuous",):                                                                                                                                                      
+        return series.astype(float)                                                                                                                                                   
+    if ftype in ("count", "numeric_ordinal"):                                                                                                                                         
+        return series.astype(int)
+    if ftype in ("categorical", "categorical_ordinal"):                                                                                                                               
+        # convert "true"/"false" strings back to booleans when appropriate
+        unique = {str(v).lower() for v in series.dropna().unique()}                                                                                                                   
+        if unique <= _BOOL_STRINGS:                                                                                                                                                   
+            return series.map({"true": True, "false": False, True: True, False: False})                                                                                               
+    return series                                                                                                                                                                     
+                                                            
+                                                                                                                                                                                        
+def synthesize_data(num_points: int = 100, sample: list | None = None, as_df: bool = True):
+    if sample is None:                                                                                                                                                                
+        r = post(endpoint='/synthesize/neighbors', payload={'n': num_points})                                                                                                         
+    else:
+        r = post(endpoint='/synthesize/blended', payload={'n': num_points, 'instance': [col.item() for col in sample]})                                                               
+    if r.status_code == 200:                                                                                                                                                          
+        payload = r.json()                                                                                                                                                            
+        if as_df:                                                                                                                                                                     
+            df = pd.DataFrame(payload['samples'], columns=payload['feature_names'])
+            for col, ftype in zip(payload['feature_names'], payload['feature_types']):                                                                                                
+                df[col] = _cast_column(df[col], ftype)
+            return df                                                                                                                                                                 
+        return payload
+    logger.error(
+        "Data synthesis failed with status %s: %s",
+        r.status_code,
+        r.text
+    )
+    return None 
+
+
+def train_surrogate(
+        samples: list, 
+        predictions: list, 
+        feature_names: list[str] | None,
+        task: str = 'auto', 
+        test_size: float = 0.2
+    ):
+    r = post(endpoint='/surrogate/train', payload={'samples': samples, 'predictions': predictions, 'feature_names': feature_names, 'task': task, 'test_size': test_size})
+    if r.status_code == 200:
+        return r.json()
+    logger.error(
+        "Surrogate training failed with status %s: %s",
+        r.status_code,
+        r.text
+    )
+    return None 
+
+
+def predict(samples: list, version: int | None):  # Defaults to latest version if not specified
+    payload = {'inputs': samples}
+    if version:  # Also rejects version 0 (versions start at 1)
+        payload['version'] = version 
+    r = post(endpoint='/surrogate/predict', payload=payload)
+    if r.status_code == 200:
+        return r.json()
+    logger.error(
+        "Surrogate prediction failed with status %s: %s",
+        r.status_code,
+        r.text
+    )
+    return None 
+
+
+def find_counterfactual(sample, target, n_neighbors: int = 10000, perturbation_scale: float = 0.1, version: int | None = None, as_df: bool = True):
+    payload = {
+        'instance': sample,
+        'target_label': target,
+        'n_neighbors': n_neighbors,
+        'perturbation_scale': perturbation_scale,
+    }
+    if version:  # Also rejects version 0 (versions start at 1)
+        payload['version'] = version 
+    r = post(endpoint='/explain/counterfactual', payload=payload)
+    if r.status_code == 200:
+        payload = r.json()                                                                                                                                                            
+        if as_df:
+            if payload['counterfactual'] is None:
+                print(f"No counterfactual found: {payload.get('warning')}")
+                return None
+            df = pd.DataFrame([payload['counterfactual']], columns=payload['feature_names'])
+            for col, ftype in zip(payload['feature_names'], payload['feature_types']):
+                df[col] = _cast_column(df[col], ftype)
+            return df
+        return payload
+    logger.error(
+        "Counterfactual failed with status %s: %s",
+        r.status_code,
+        r.text
+    )
+    return None 
+
+
+def interpret_counterfactual(
+    sample: dict,
+    counterfactual: dict,
+    prediction_changed: bool,
+    exclude_from_diff: list[str] | None
+) -> str:
+    if not exclude_from_diff:
+        exclude_from_diff = list()
+    diffs = {
+        k: (sample[k], counterfactual[k])
+        for k in sample
+        if sample[k] != counterfactual[k]
+        and k not in exclude_from_diff
+    }
+    
+    if not diffs:
+        return "No meaningful differences found between sample and counterfactual."
+    
+    changes = ", ".join(
+        f"{feature} from {original} to {cf_value}"
+        for feature, (original, cf_value) in diffs.items()
+    )
+    
+    if prediction_changed:
+        return (
+            f"Changing {changes} may result in a different prediction. "
+            f"Note: this is based on a surrogate model and should be treated as approximate."
+        )
+    else:
+        return (
+            f"A counterfactual was found suggesting {changes}, however "
+            f"the original model's prediction did not change. "
+            f"This may indicate the surrogate model does not fully capture "
+            f"the original model's decision boundary in this region."
+        )

proxyml/schema.py

@@ -0,0 +1,59 @@
+import logging
+logger = logging.getLogger(__name__)
+
+import os
+import numpy as np
+import pandas as pd
+from pandas.api.types import is_float_dtype, is_integer_dtype
+
+
+def gen_continuous_schema(s: pd.Series, name: str | None = None) -> dict:
+    return {
+        'type': 'continuous',
+        'name': name or s.name,
+        'mean': np.nanmean(s).item(),
+        'std': np.nanstd(s).item(),
+        'min': np.nanmin(s).item(),
+        'max': np.nanmax(s).item()
+    }
+
+
+def gen_categorical_schema(s: pd.Series, name: str | None = None) -> dict:
+    counts = s.value_counts(normalize=True)                                                                                                                                         
+    return {                                        
+        'type': 'categorical',
+        'name': name or s.name,          
+        'valid_categories': counts.to_dict()
+    }
+
+
+def gen_discrete_schema(s: pd.Series, name: str | None = None) -> dict:
+    return {                                        
+        'type': 'count',
+        'name': name or s.name,    
+        'lambda': np.nanmean(s).item(),
+        'max': np.nanmax(s).item()
+    }
+
+
+def get_schema(df: pd.DataFrame, immutable_cols: list[str] | None) -> dict:
+    schema = {
+        'features': list(),
+        '_note': (
+            'Auto-generated schema. Review and adjust types as needed. '
+            'Integer columns default to count type - consider categorical_ordinal '
+            'for ordered categories like ratings or class labels.'
+        )
+    }
+    for col in df.columns:
+        if is_float_dtype(df[col]):
+            col_schema = gen_continuous_schema(df[col])
+        elif df[col].dtype == bool:
+            col_schema = gen_categorical_schema(df[col])
+        elif is_integer_dtype(df[col]):
+            col_schema = gen_discrete_schema(df[col])
+        else:
+            col_schema = gen_categorical_schema(df[col])
+        col_schema['immutable'] = immutable_cols is not None and col in immutable_cols
+        schema['features'].append(col_schema)
+    return schema

proxyml-0.1.0.dist-info/METADATA

@@ -0,0 +1,329 @@
+Metadata-Version: 2.4
+Name: proxyml
+Version: 0.1.0
+Summary: Python SDK for calling the ProxyML API
+Author-email: ProxyML <contact@proxyml.ai>
+License:                                  Apache License
+                                   Version 2.0, January 2004
+                                http://www.apache.org/licenses/
+        
+           TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+        
+           1. Definitions.
+        
+              "License" shall mean the terms and conditions for use, reproduction,
+              and distribution as defined by Sections 1 through 9 of this document.
+        
+              "Licensor" shall mean the copyright owner or entity authorized by
+              the copyright owner that is granting the License.
+        
+              "Legal Entity" shall mean the union of the acting entity and all
+              other entities that control, are controlled by, or are under common
+              control with that entity. For the purposes of this definition,
+              "control" means (i) the power, direct or indirect, to cause the
+              direction or management of such entity, whether by contract or
+              otherwise, or (ii) ownership of fifty percent (50%) or more of the
+              outstanding shares, or (iii) beneficial ownership of such entity.
+        
+              "You" (or "Your") shall mean an individual or Legal Entity
+              exercising permissions granted by this License.
+        
+              "Source" form shall mean the preferred form for making modifications,
+              including but not limited to software source code, documentation
+              source, and configuration files.
+        
+              "Object" form shall mean any form resulting from mechanical
+              transformation or translation of a Source form, including but
+              not limited to compiled object code, generated documentation,
+              and conversions to other media types.
+        
+              "Work" shall mean the work of authorship made available under
+              the License, as indicated by a copyright notice that is included in
+              or attached to the work (an example is provided in the Appendix below).
+        
+              "Derivative Works" shall mean any work, whether in Source or Object
+              form, that is based on (or derived from) the Work and for which the
+              editorial revisions, annotations, elaborations, or other modifications
+              represent, as a whole, an original work of authorship. For the purposes
+              of this License, Derivative Works shall not include works that remain
+              separable from, or merely link (or bind by name) to the interfaces of,
+              the Work and Derivative Works thereof.
+        
+              "Contribution" shall mean, as submitted to the Licensor for inclusion
+              in the Work by the copyright owner or by an individual or Legal Entity
+              authorized to submit on behalf of the copyright owner. For the purposes
+              of this definition, "submitted" means any form of electronic, verbal,
+              or written communication sent to the Licensor or its representatives,
+              including but not limited to communication on electronic mailing lists,
+              source code control systems, and issue tracking systems that are managed
+              by, or on behalf of, the Licensor for the purpose of developing and
+              discussing the Work, but excluding communication that is conspicuously
+              marked or designated in writing by the copyright owner as "Not a
+              Contribution."
+        
+              "Contributor" shall mean Licensor and any Legal Entity on behalf of
+              whom a Contribution has been received by the Licensor and included
+              within the Work.
+        
+           2. Grant of Copyright License. Subject to the terms and conditions of
+              this License, each Contributor hereby grants to You a perpetual,
+              worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+              copyright license to reproduce, prepare Derivative Works of,
+              publicly display, publicly perform, sublicense, and distribute the
+              Work and such Derivative Works in Source or Object form.
+        
+           3. Grant of Patent License. Subject to the terms and conditions of
+              this License, each Contributor hereby grants to You a perpetual,
+              worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+              (except as stated in this section) patent license to make, have made,
+              use, offer to sell, sell, import, and otherwise transfer the Work,
+              where such license applies only to those patent claims licensable
+              by such Contributor that are necessarily infringed by their
+              Contribution(s) alone or by the combination of their Contribution(s)
+              with the Work to which such Contribution(s) was submitted. If You
+              institute patent litigation against any entity (including a cross-claim
+              or counterclaim in a lawsuit) alleging that the Work or any other
+              Contribution incorporated within the Work constitutes patent or
+              contributory patent infringement, then any patent licenses granted to
+              You under this License for that Work shall terminate as of the date
+              such litigation is filed.
+        
+           4. Redistribution. You may reproduce and distribute copies of the
+              Work or Derivative Works thereof in any medium, with or without
+              modifications, and in Source or Object form, provided that You
+              meet the following conditions:
+        
+              (a) You must give any other recipients of the Work or Derivative
+                  Works a copy of this License; and
+        
+              (b) You must cause any modified files to carry prominent notices
+                  stating that You changed the files; and
+        
+              (c) You must retain, in the Source form of any Derivative Works
+                  that You distribute, all copyright, patent, trademark, and
+                  attribution notices from the Source form of the Work,
+                  excluding those notices that do not pertain to any part of
+                  the Derivative Works; and
+        
+              (d) If the Work includes a "NOTICE" text file as part of its
+                  distribution, You must include a readable copy of the
+                  attribution notices contained within such NOTICE file, in
+                  at least one of the following places: within a NOTICE text
+                  file distributed as part of the Derivative Works; within
+                  the Source form or documentation, if provided along with the
+                  Derivative Works; or, within a display generated by the
+                  Derivative Works, if and wherever such third-party notices
+                  normally appear. The contents of the NOTICE file are for
+                  informational purposes only and do not modify the License.
+                  You may add Your own attribution notices within Derivative
+                  Works that You distribute, alongside or in addition to the
+                  NOTICE text from the Work, provided that such additional
+                  attribution notices cannot be construed as modifying the License.
+        
+              You may add Your own license statement for Your modifications and
+              may provide additional grant of rights to use, copy, modify, merge,
+              publish, distribute, sublicense, and/or sell copies of the
+              Contribution and such Derivative Works.
+        
+           5. Submission of Contributions. Unless You explicitly state otherwise,
+              any Contribution intentionally submitted for inclusion in the Work
+              by You to the Licensor shall be under the terms and conditions of
+              this License, without any additional terms or conditions.
+              Notwithstanding the above, nothing herein shall supersede or modify
+              the terms of any separate license agreement you may have executed
+              with Licensor regarding such Contributions.
+        
+           6. Trademarks. This License does not grant permission to use the trade
+              names, trademarks, service marks, or product names of the Licensor,
+              except as required for reasonable and customary use in describing the
+              origin of the Work and reproducing the content of the NOTICE file.
+        
+           7. Disclaimer of Warranty. Unless required by applicable law or
+              agreed to in writing, Licensor provides the Work (and each
+              Contributor provides its Contributions) on an "AS IS" BASIS,
+              WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+              implied, including, without limitation, any conditions of TITLE,
+              NONINFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+              PURPOSE. You are solely responsible for determining the
+              appropriateness of using or reproducing the Work and assume any
+              risks associated with Your exercise of permissions under this License.
+        
+           8. Limitation of Liability. In no event and under no legal theory,
+              whether in tort (including negligence), contract, or otherwise,
+              unless required by applicable law (such as deliberate and grossly
+              negligent acts) or agreed to in writing, shall any Contributor be
+              liable to You for damages, including any direct, indirect, special,
+              incidental, or exemplary damages of any character arising as a
+              result of this License or out of the use or inability to use the
+              Work (including but not limited to damages for loss of goodwill,
+              work stoppage, computer failure or malfunction, or all other
+              commercial damages or losses), even if such Contributor has been
+              advised of the possibility of such damages.
+        
+           9. Accepting Warranty or Additional Liability. While redistributing
+              the Work or Derivative Works thereof, You may choose to offer,
+              and charge a fee for, acceptance of support, warranty, indemnity,
+              or other liability obligations and/or rights consistent with this
+              License. However, in accepting such obligations, You may charge only
+              on Your own behalf and on Your sole responsibility, not on behalf of
+              any other Contributor, and only if You agree to indemnify, defend,
+              and hold each Contributor harmless for any liability incurred by,
+              or claims asserted against, such Contributor by reason of your
+              accepting any warranty or additional liability.
+        
+           END OF TERMS AND CONDITIONS
+        
+           Copyright 2026 ProxyML
+        
+           Licensed under the Apache License, Version 2.0 (the "License");
+           you may not use this file except in compliance with the License.
+           You may obtain a copy of the License at
+        
+               http://www.apache.org/licenses/LICENSE-2.0
+        
+           Unless required by applicable law or agreed to in writing, software
+           distributed under the License is distributed on an "AS IS" BASIS,
+           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+           See the License for the specific language governing permissions and
+           limitations under the License.
+        
+Project-URL: Homepage, https://proxyml.ai
+Project-URL: Documentation, https://github.com/proxyml/proxyml-sdk-python/blob/main/docs/quickstart.md
+Project-URL: Repository, https://github.com/proxyml/proxyml-sdk-python
+Project-URL: Bug Tracker, https://github.com/proxyml/proxyml-sdk-python/issues
+Keywords: machine learning,api,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28
+Requires-Dist: numpy>=1.23
+Requires-Dist: pandas>=1.5
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Dynamic: license-file
+
+# proxyml
+
+Python SDK for the [ProxyML API](https://proxyml.ai).
+
+> **Status:** Early access — server endpoints coming soon.  
+> [Request early access](mailto:contact@proxyml.ai) or star this repo to follow progress.
+
+## Why ProxyML?
+
+Most explainability tools require sending your data to a third-party server. 
+ProxyML never sees your training data. You generate synthetic data locally, 
+score it with your own model, and only the surrogate model and summary 
+statistics are uploaded — your data stays yours.
+
+## Installation
+
+```bash
+pip install proxyml
+```
+
+## Setup
+
+ProxyML requires an API key. Set it as an environment variable before importing the package:
+
+```bash
+export PROXYML_API_KEY="your-api-key"
+```
+
+Optionally override the base URL (defaults to `https://api.proxyml.ai/api/v1`):
+
+```bash
+export PROXYML_BASE_URL="https://api.proxyml.ai/api/v1"
+```
+
+## Quick Start
+
+```python
+import pandas as pd
+import proxyml
+from proxyml import get_schema
+
+# 1. Load your dataset and generate a schema
+df = pd.read_csv("data.csv")
+schema = get_schema(df, immutable_cols=["age", "gender"])
+
+# 2. Upload the schema
+proxyml.put_schema(schema)
+
+# 3. Generate synthetic training data
+synth_df = proxyml.synthesize_data(num_points=500)
+
+# 4. Score synthetic data with your black-box model
+predictions = my_model.predict(synth_df.values.tolist())
+
+# 5. Train a surrogate model
+proxyml.train_surrogate(
+    samples=synth_df.values.tolist(),
+    predictions=predictions,
+    feature_names=list(synth_df.columns),
+)
+
+# 6. Find a counterfactual explanation
+sample = df.iloc[0].tolist()
+cf = proxyml.find_counterfactual(sample=sample, target=1, version=None)
+
+if cf is not None:
+    original = synth_df.iloc[0].to_dict()
+    cf_dict = cf.iloc[0].to_dict()
+    current_pred = my_model.predict([sample])[0]
+    cf_pred = my_model.predict([cf.values.tolist()[0]])[0]
+
+    explanation = proxyml.interpret_counterfactual(
+        sample=original,
+        counterfactual=cf_dict,
+        prediction_changed=(current_pred != cf_pred),
+    )
+    print(explanation)
+```
+
+See [`docs/quickstart.md`](docs/quickstart.md) for a full walkthrough and [`docs/api.md`](docs/api.md) for complete API reference.
+
+## Core Concepts
+
+**Surrogate model** — A fast, interpretable model trained to approximate your black-box model's behavior on synthetic data. Once trained, it can be queried directly via the ProxyML API.
+
+**Counterfactual explanation** — Given a prediction, a counterfactual is the minimal change to input features that would produce a different prediction. It answers: *"What would have to be different for the outcome to change?"*
+
+**Schema** — Describes the statistical properties of each feature (type, range, distribution). Used to generate realistic synthetic data and constrain counterfactual search.
+
+## API Reference
+
+| Function | Description |
+|---|---|
+| `get_schema(df, immutable_cols)` | Generate a schema dict from a DataFrame |
+| `put_schema(schema)` | Upload a schema to the API |
+| `synthesize_data(num_points, sample, as_df)` | Generate synthetic data points |
+| `train_surrogate(samples, predictions, feature_names, task, test_size)` | Train a surrogate model |
+| `predict(samples, version)` | Score samples with the surrogate model |
+| `find_counterfactual(sample, target, ...)` | Find a counterfactual for a given sample |
+| `interpret_counterfactual(sample, counterfactual, ...)` | Generate a human-readable explanation |
+
+Full documentation: [`docs/api.md`](docs/api.md)
+
+## Examples
+
+- [`examples/basic_usage.py`](examples/basic_usage.py) — Schema upload, data synthesis, surrogate training
+- [`examples/counterfactual_example.py`](examples/counterfactual_example.py) — Counterfactual search and interpretation
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE).

proxyml-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+proxyml/__init__.py,sha256=XXZvFE6KjzY08LKiJ7vzRz0MprGATZc0xuGKXHTA4m0,541
+proxyml/client.py,sha256=iT65zgaB5zGlvSBqv7eMx_flSa_R9s2nLZxOGmd16NA,8717
+proxyml/schema.py,sha256=GWfcw0tYHSvGlDLWzfov5RZMk9wFEXbMKU4G-R9iEbA,2077
+proxyml-0.1.0.dist-info/licenses/LICENSE,sha256=g3kg6VH6Fi9-VhRB0ZYTPsVKUAMx7D9UsoZMJ_KZtko,10196
+proxyml-0.1.0.dist-info/METADATA,sha256=XJZH-jlgmHVI8YQujDWuYlE9SHpXLE9rr6JClnotP8c,16872
+proxyml-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+proxyml-0.1.0.dist-info/top_level.txt,sha256=aZJqLvh74AOsYI5zvINna2cq8hW6wCiF2dCSt8QAkQ8,8
+proxyml-0.1.0.dist-info/RECORD,,

proxyml-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

proxyml-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,183 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship made available under
+      the License, as indicated by a copyright notice that is included in
+      or attached to the work (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean, as submitted to the Licensor for inclusion
+      in the Work by the copyright owner or by an individual or Legal Entity
+      authorized to submit on behalf of the copyright owner. For the purposes
+      of this definition, "submitted" means any form of electronic, verbal,
+      or written communication sent to the Licensor or its representatives,
+      including but not limited to communication on electronic mailing lists,
+      source code control systems, and issue tracking systems that are managed
+      by, or on behalf of, the Licensor for the purpose of developing and
+      discussing the Work, but excluding communication that is conspicuously
+      marked or designated in writing by the copyright owner as "Not a
+      Contribution."
+
+      "Contributor" shall mean Licensor and any Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor and included
+      within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by the combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a cross-claim
+      or counterclaim in a lawsuit) alleging that the Work or any other
+      Contribution incorporated within the Work constitutes patent or
+      contributory patent infringement, then any patent licenses granted to
+      You under this License for that Work shall terminate as of the date
+      such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, You must include a readable copy of the
+          attribution notices contained within such NOTICE file, in
+          at least one of the following places: within a NOTICE text
+          file distributed as part of the Derivative Works; within
+          the Source form or documentation, if provided along with the
+          Derivative Works; or, within a display generated by the
+          Derivative Works, if and wherever such third-party notices
+          normally appear. The contents of the NOTICE file are for
+          informational purposes only and do not modify the License.
+          You may add Your own attribution notices within Derivative
+          Works that You distribute, alongside or in addition to the
+          NOTICE text from the Work, provided that such additional
+          attribution notices cannot be construed as modifying the License.
+
+      You may add Your own license statement for Your modifications and
+      may provide additional grant of rights to use, copy, modify, merge,
+      publish, distribute, sublicense, and/or sell copies of the
+      Contribution and such Derivative Works.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any conditions of TITLE,
+      NONINFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+      PURPOSE. You are solely responsible for determining the
+      appropriateness of using or reproducing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or exemplary damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or all other
+      commercial damages or losses), even if such Contributor has been
+      advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may charge only
+      on Your own behalf and on Your sole responsibility, not on behalf of
+      any other Contributor, and only if You agree to indemnify, defend,
+      and hold each Contributor harmless for any liability incurred by,
+      or claims asserted against, such Contributor by reason of your
+      accepting any warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 ProxyML
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

proxyml-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+proxyml