uncertainty-engine


Nameuncertainty-engine JSON
Version 0.7.0 PyPI version JSON
download
home_pageNone
SummarySDK for the Uncertainty Engine
upload_time2025-08-04 09:36:43
maintainerJamie Donald-McCann
docs_urlNone
authordigiLab Solutions Ltd.
requires_python<3.13,>=3.10
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ![Uncertainty Engine banner](https://github.com/digiLab-ai/uncertainty-engine-types/raw/main/assets/images/uncertainty-engine-logo.png)

# Python SDK for the Uncertainty Engine

[![PyPI](https://badge.fury.io/py/uncertainty-engine.svg)](https://badge.fury.io/py/uncertainty-engine) [![Python Versions](https://img.shields.io/pypi/pyversions/uncertainty-engine.svg)](https://pypi.org/project/uncertainty-engine/)

## Requirements

- Python >=3.10, <3.13
- Valid Uncertainty Engine account

## Installation

```bash
pip install uncertainty-engine
```

With optional dependencies:

```bash
pip install "uncertainty_engine[vis,notebook,data]"
```

## Usage

### Setting your username and password

To run and queue workflows you must have your Uncertainty Engine username and password set up. To do this you can run the following in your terminal:

```bash
export UE_USERNAME="your_username"
export UE_PASSWORD="your_password"
```

### Creating a client

All interactions with the Uncertainty Engine API are performed via a `Client`. The client can be defined as follows:

```python
from uncertainty_engine import Client

client = Client()
```

To create a `Client` for a named environment:

```python
from uncertainty_engine import Client

client = Client(env="<NAME>")

# For example:
client = Client(env="dev")
```

To create a `Client` for a custom environment:

```python
from uncertainty_engine import Client, Environment

client = Client(
   env=Environment(
        cognito_user_pool_client_id="<COGNITO USER POOL APPLICATION CLIENT ID>",
        core_api="<UNCERTAINTY ENGINE CORE API URL>",
        region="<REGION>",
        resource_api="<UNCERTAINTY ENGINE RESOURCE SERVICE API URL>",
   ),
)

# For example:
client = Client(
   env=Environment(
        cognito_user_pool_client_id="3n437fei4uhp4ouj8b4mmt09l9",
        core_api="https://s0r8fczyag.execute-api.eu-west-2.amazonaws.com",
        region="eu-west-2",
        resource_api="https://hmqdnx48x6.execute-api.eu-west-2.amazonaws.com",
   ),
)
```

### Running a node

```python
from pprint import pprint

from uncertainty_engine import Client, Environment
from uncertainty_engine.nodes.basic import Add

# Set up the client
client = Client(
   env=Environment(
        cognito_user_pool_client_id="<COGNITO USER POOL APPLICATION CLIENT ID>",
        core_api="<UNCERTAINTY ENGINE CORE API URL>",
        region="<REGION>",
        resource_api="<UNCERTAINTY ENGINE RESOURCE SERVICE API URL>",
   ),
)

# Create a node
add = Add(lhs=1, rhs=2)

# Run the node on the server
response = client.run_node(add)

# Get the result
result = response.outputs

pprint(result)
```

For more some more in-depth examples checkout our [example notebooks](https://github.com/digiLab-ai/uncertainty-engine-sdk/tree/dev/examples).

## Support

For any support needs please visit our [support page](https://support.uncertaintyengine.ai).

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "uncertainty-engine",
    "maintainer": "Jamie Donald-McCann",
    "docs_url": null,
    "requires_python": "<3.13,>=3.10",
    "maintainer_email": "jamie.donald-mccann@digilab.ai",
    "keywords": null,
    "author": "digiLab Solutions Ltd.",
    "author_email": "info@digilab.ai",
    "download_url": "https://files.pythonhosted.org/packages/2d/5d/b531052c296069ff5d489b676c1c331535707fc5d6575ea97a192dbe3021/uncertainty_engine-0.7.0.tar.gz",
    "platform": null,
    "description": "![Uncertainty Engine banner](https://github.com/digiLab-ai/uncertainty-engine-types/raw/main/assets/images/uncertainty-engine-logo.png)\n\n# Python SDK for the Uncertainty Engine\n\n[![PyPI](https://badge.fury.io/py/uncertainty-engine.svg)](https://badge.fury.io/py/uncertainty-engine) [![Python Versions](https://img.shields.io/pypi/pyversions/uncertainty-engine.svg)](https://pypi.org/project/uncertainty-engine/)\n\n## Requirements\n\n- Python >=3.10, <3.13\n- Valid Uncertainty Engine account\n\n## Installation\n\n```bash\npip install uncertainty-engine\n```\n\nWith optional dependencies:\n\n```bash\npip install \"uncertainty_engine[vis,notebook,data]\"\n```\n\n## Usage\n\n### Setting your username and password\n\nTo run and queue workflows you must have your Uncertainty Engine username and password set up. To do this you can run the following in your terminal:\n\n```bash\nexport UE_USERNAME=\"your_username\"\nexport UE_PASSWORD=\"your_password\"\n```\n\n### Creating a client\n\nAll interactions with the Uncertainty Engine API are performed via a `Client`. The client can be defined as follows:\n\n```python\nfrom uncertainty_engine import Client\n\nclient = Client()\n```\n\nTo create a `Client` for a named environment:\n\n```python\nfrom uncertainty_engine import Client\n\nclient = Client(env=\"<NAME>\")\n\n# For example:\nclient = Client(env=\"dev\")\n```\n\nTo create a `Client` for a custom environment:\n\n```python\nfrom uncertainty_engine import Client, Environment\n\nclient = Client(\n   env=Environment(\n        cognito_user_pool_client_id=\"<COGNITO USER POOL APPLICATION CLIENT ID>\",\n        core_api=\"<UNCERTAINTY ENGINE CORE API URL>\",\n        region=\"<REGION>\",\n        resource_api=\"<UNCERTAINTY ENGINE RESOURCE SERVICE API URL>\",\n   ),\n)\n\n# For example:\nclient = Client(\n   env=Environment(\n        cognito_user_pool_client_id=\"3n437fei4uhp4ouj8b4mmt09l9\",\n        core_api=\"https://s0r8fczyag.execute-api.eu-west-2.amazonaws.com\",\n        region=\"eu-west-2\",\n        resource_api=\"https://hmqdnx48x6.execute-api.eu-west-2.amazonaws.com\",\n   ),\n)\n```\n\n### Running a node\n\n```python\nfrom pprint import pprint\n\nfrom uncertainty_engine import Client, Environment\nfrom uncertainty_engine.nodes.basic import Add\n\n# Set up the client\nclient = Client(\n   env=Environment(\n        cognito_user_pool_client_id=\"<COGNITO USER POOL APPLICATION CLIENT ID>\",\n        core_api=\"<UNCERTAINTY ENGINE CORE API URL>\",\n        region=\"<REGION>\",\n        resource_api=\"<UNCERTAINTY ENGINE RESOURCE SERVICE API URL>\",\n   ),\n)\n\n# Create a node\nadd = Add(lhs=1, rhs=2)\n\n# Run the node on the server\nresponse = client.run_node(add)\n\n# Get the result\nresult = response.outputs\n\npprint(result)\n```\n\nFor more some more in-depth examples checkout our [example notebooks](https://github.com/digiLab-ai/uncertainty-engine-sdk/tree/dev/examples).\n\n## Support\n\nFor any support needs please visit our [support page](https://support.uncertaintyengine.ai).\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "SDK for the Uncertainty Engine",
    "version": "0.7.0",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2fc6a1b2d037466872bd0c37f1c4d75a7e99ca247421e72182ef3c4dd19c4675",
                "md5": "ad86bc784ae4dba8db4299060d7e852b",
                "sha256": "1cd85f8c3d72d6d6a50849ef05d8637d65a0d340289c700a87d845e8089d958b"
            },
            "downloads": -1,
            "filename": "uncertainty_engine-0.7.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ad86bc784ae4dba8db4299060d7e852b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<3.13,>=3.10",
            "size": 31339,
            "upload_time": "2025-08-04T09:36:42",
            "upload_time_iso_8601": "2025-08-04T09:36:42.907033Z",
            "url": "https://files.pythonhosted.org/packages/2f/c6/a1b2d037466872bd0c37f1c4d75a7e99ca247421e72182ef3c4dd19c4675/uncertainty_engine-0.7.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2d5db531052c296069ff5d489b676c1c331535707fc5d6575ea97a192dbe3021",
                "md5": "8e375c0d255bcb12860d47d2df94d5b0",
                "sha256": "d0316ed173dd2a83f944ba48d56669d6b3ca19d7fe059c002df6420a216c9691"
            },
            "downloads": -1,
            "filename": "uncertainty_engine-0.7.0.tar.gz",
            "has_sig": false,
            "md5_digest": "8e375c0d255bcb12860d47d2df94d5b0",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<3.13,>=3.10",
            "size": 20897,
            "upload_time": "2025-08-04T09:36:43",
            "upload_time_iso_8601": "2025-08-04T09:36:43.851809Z",
            "url": "https://files.pythonhosted.org/packages/2d/5d/b531052c296069ff5d489b676c1c331535707fc5d6575ea97a192dbe3021/uncertainty_engine-0.7.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-04 09:36:43",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "uncertainty-engine"
}
        
Elapsed time: 1.70185s