{"id":18358953,"url":"https://github.com/nannyml/nannyml-cloud-sdk","last_synced_at":"2026-02-13T15:39:59.464Z","repository":{"id":206943289,"uuid":"712348379","full_name":"NannyML/nannyml-cloud-sdk","owner":"NannyML","description":"SDK for programmatically interfacing NannyML Cloud","archived":false,"fork":false,"pushed_at":"2025-02-24T22:56:47.000Z","size":906,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-06T13:37:01.037Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NannyML.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-31T09:43:41.000Z","updated_at":"2025-02-24T22:55:21.000Z","dependencies_parsed_at":"2023-11-15T15:27:38.341Z","dependency_job_id":"8d3da4c4-fb22-40f7-ac85-9941e730efcf","html_url":"https://github.com/NannyML/nannyml-cloud-sdk","commit_stats":null,"previous_names":["nannyml/nannyml-cloud-sdk"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/NannyML/nannyml-cloud-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NannyML%2Fnannyml-cloud-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NannyML%2Fnannyml-cloud-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NannyML%2Fnannyml-cloud-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NannyML%2Fnannyml-cloud-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NannyML","download_url":"https://codeload.github.com/NannyML/nannyml-cloud-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NannyML%2Fnannyml-cloud-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29411184,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-13T06:24:03.484Z","status":"ssl_error","status_checked_at":"2026-02-13T06:23:12.830Z","response_time":78,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-05T22:20:00.513Z","updated_at":"2026-02-13T15:39:59.439Z","avatar_url":"https://github.com/NannyML.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"media/thumbnail-4.png\"\u003e\n\u003c/p\u003e\n\n# 💡 What is NannyML Cloud SDK?\n\nNannyML Cloud is a web application that allows you to **estimate post-deployment model performance** (without access to targets), detect data drift, and intelligently link data drift alerts back to changes in model performance. Built for data scientists, NannyML Cloud has an easy-to-use interface, interactive visualizations, is completely model-agnostic and currently supports all tabular use cases, classification and **regression**.\n\nNannyML Cloud SDK is a python package that enables programatic interaction with NannyML Cloud. It allows you to automate all aspects of NannyML Cloud, including:\n\n- Creating a model for monitoring\n- Logging inferences for analysis\n- Triggering model analysis\n\n# 🚀 Getting started\n\n### Install NannyML Cloud SDK\n\nThe nannyml-cloud-sdk package is available on PyPi and can be installed using your favorite package manager. \n\n### Compatibility\n\nYou can check which SDK version support which NannyML Cloud versions over on the [dedicated cloud documentation page](https://docs.nannyml.com/cloud/nannyml-cloud-sdk/getting-started#compatibility).\n\n### Authentication\n\nTo use the NannyML Cloud SDK you need to provide the URL of your NannyML Cloud instance and an API token to authenticate. You can obtain an API token on the settings page of your NannyML Cloud instance.\n\nIn code:\n\n``` python\nimport nannyml_cloud_sdk as nml_sdk\n\nnml_sdk.url = \"https://beta.app.nannyml.com\"\nnml_sdk.api_token = r\"api token goes here\"\n```\n\nUsing environment variables:\n\n``` python\nimport nannyml_cloud_sdk as nml_sdk\nimport os\n\nnml_sdk.url = os.environ['NML_SDK_URL']\nnml_sdk.api_token = os.environ['NML_SDK_API_TOKEN']\n```\n\n\u003e [!NOTE]\n\u003e We recommend using an environment variable for the API token. This prevents accidentally leaking any token associated with your personal account when sharing code.\n\n### Quick start\n\nThis snippet provides an example of how you can create a model in NannyML Cloud to start monitoring it.\n\n``` python\nimport nannyml_cloud_sdk as nml_sdk\nimport os\nimport pandas as pd\n\nnml_sdk.url = os.environ['NML_SDK_URL']\nnml_sdk.api_token = os.environ['NML_SDK_API_TOKEN']\n\n# Load a NannyML binary classification dataset to use as example\nreference_data = pd.read_csv('https://github.com/NannyML/nannyml/raw/main/nannyml/datasets/data/synthetic_sample_reference.csv')\nanalysis_data = pd.read_csv('https://github.com/NannyML/nannyml/raw/main/nannyml/datasets/data/synthetic_sample_analysis.csv')\ntarget_data = pd.read_csv('https://github.com/NannyML/nannyml/raw/main/nannyml/datasets/data/synthetic_sample_analysis_gt.csv')\nprint(reference_data.head())\n\n# Inspect schema from dataset and apply overrides\nschema = nml_sdk.monitoring.Schema.from_df(\n    'BINARY_CLASSIFICATION',\n    reference_data,\n    target_column_name='work_home_actual',\n    ignore_column_names=('period'),\n)\n\n# Create model\nmodel = nml_sdk.monitoring.Model.create(\n    name='Example model',\n    schema=schema,\n    chunk_period='MONTHLY',\n    reference_data=reference_data,\n    analysis_data=analysis_data,\n    target_data=target_data,\n    key_performance_metric='F1',\n)\nprint(\"Model\", model['id'], \"created at\", model['createdAt'])\n```\n\n\u003e [!NOTE]\n\u003e The reference dataset is inspected to determine the model schema. NannyML Cloud uses heuristics to automatically identify most columns, but some columns may not be automatically identified. In this case the target column is not identified, so we manually define `work_home_actual` as the target column.\n\nOnce a model has been set up in NannyML Cloud, you could use the snippet below to add more data and ensure continuous monitoring of your model.\n\n``` python\nimport nannyml_cloud_sdk as nml_sdk\nimport os\nimport pandas as pd\n\nnml_sdk.url = os.environ['NML_SDK_URL']\nnml_sdk.api_token = os.environ['NML_SDK_API_TOKEN']\n\n# Find model in NannyML Cloud by name\nmodel, = nml_sdk.monitoring.Model.list(name='Example model')\n\n# Add new inferences to NannyML Cloud\nnew_inferences = pd.DataFrame()\nnml_sdk.monitoring.Model.add_analysis_data(model['id'], new_inferences)\n\n# If you have delayed access to ground truth, you can add them to NannyML Cloud\n# later. This will match analysis \u0026 target datasets using an identifier column.\ndelayed_ground_truth = pd.DataFrame()\nnml_sdk.monitoring.Model.add_analysis_target_data(model['id'], delayed_ground_truth)\n\n# Trigger analysis of the new data\nnml_sdk.monitoring.Run.trigger(model['id'])\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnannyml%2Fnannyml-cloud-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnannyml%2Fnannyml-cloud-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnannyml%2Fnannyml-cloud-sdk/lists"}