<div align="center">
# :hammer: Datature Python SDK :hammer:
[](https://pypi.org/project/datature)
[](https://pypi.org/project/datature)
[](https://pypi.org/project/datature)
[](https://datature.io/community) [](https://lbesson.apache-license.org/)
<a href="https://datature.io"><img src="assets/datature.svg" width="3%"/></a><img src="assets/transparent.png" width="3%"/>
<a href="https://www.datature.io/blog"><img src="assets/blog.svg" width="3%"/></a><img src="assets/transparent.png" width="3%"/>
<a href="https://developers.datature.io/"><img src="https://cdn.simpleicons.org/readme/#018EF5" width="3%"/></a><img src="assets/transparent.png" width="3%"/>
<a href="https://www.youtube.com/channel/UCd3UQZ9piasi0vgfg5xI59w"><img src="https://cdn.simpleicons.org/youtube/#FF0000" width="3%"/></a><img src="assets/transparent.png" width="3%"/>
<a href="https://www.linkedin.com/company/datature/"><img src="https://cdn.simpleicons.org/linkedin/#0A66C2" width="3%"/></a><img src="assets/transparent.png" width="3%"/>
<a href="https://twitter.com/DatatureAI"><img src="https://cdn.simpleicons.org/twitter/#1D9BF0" width="3%"/></a><img src="assets/transparent.png" width="3%"/>
<a href="https://datature.io/community"><img src="assets/slack.png" width="3%"/></a>
---
:zap: Empower your MLOps pipelines and applications with seamless integrations :zap:
Automate tasks to manage your datasets, run training experiments, export and deploy your models from [Datature Nexus](https://www.datature.io/nexus?utm_source=github) with ease. Perform development via [Python Scripts](#python-usage) or with the [Command-Line Interface](#cli-usage).
</div>
---
<div align="center">
## Getting Started
</div>
## Prerequisites
- `3.8` <= Python <= `3.12`
We recommend users to create a virtual environment before installing any dependencies. For more information on virtual environments, please refer to:
- [Python venv](https://docs.python.org/3/tutorial/venv.html)
- [Conda](https://conda.io/projects/conda/en/stable/user-guide/install/index.html)
- [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/)
## Installation
```sh
pip install --upgrade datature
```
---
## Python Usage
For a full list of documentation and examples, please refer to the [API docs](https://developers.datature.io/docs/python-sdk).
### Authentication
To get started, you will first need to create a project on [Datature Nexus](https://www.datature.io/nexus?utm_source=github) (you can create sign up for a free account [here](https://nexus.datature.io/)). You will then need to locate the [project secret key](https://developers.datature.io/docs/project-keys-and-secret-keys). This key can only be accessed if you are the Project Owner or have been granted elevated permissions by the Project Owner, and will be used for all subsequent authentication when invoking the various SDK functions.
### Examples
To list projects:
```python
from datature import nexus
client = nexus.Client("31a9f0dd997cb632765fc0d222369f6106327c3d20719d31f6ffafe51708f117")
projects = client.list_projects()
```
To upload assets:
```python
import os
from datature import nexus
logging.basicConfig()
client = nexus.Client("31a9f0dd997cb632765fc0d222369f6106327c3d20719d31f6ffafe51708f117")
project = client.get_project("fca32b1bb15405d1c2bde19fd90b516d")
upload_session = project.assets.create_upload_session(groups=["dataset"])
with upload_session as session:
session.add_path("/Users/dataset")
print(len(upload_session))
```
### Logging
You can vary the logging level depending on your task or use case (such as `DEBUG` to provide more insights), but the default `INFO` level is typically best suited for production use.
```python
import logging
logging.basicConfig()
logging.getLogger("datature-nexus").setLevel(logging.DEBUG)
```
---
## CLI Usage
For a full list of documentation and examples, please refer to the [CLI docs](https://developers.datature.io/docs/cli).
### Authentication
To get started, you will first need to create a project on [Datature Nexus](https://www.datature.io/nexus?utm_source=github) (you can create sign up for a free account [here](https://nexus.datature.io/)). You will then need to locate the [project secret key](https://developers.datature.io/docs/project-keys-and-secret-keys). This key can only be accessed if you are the Project Owner or have been granted elevated permissions by the Project Owner, and will be used for all subsequent authentication when invoking the various SDK functions.
Once you have the project secret, you will now be able to make API requests using the CLI by entering the command `datature projects auth`:
```bash
datature projects auth
[?] Enter the project secret: ************************************************
[?] Make [Your Project Name] the default project? (Y/n): y
Authentication succeeded.
```
You will now be able to run your desired CLI commands as outlined above. To see all possible functions as well as view the required inputs and expected outputs, check out the following documentation.
### Project Management
`datature projects`
Show a help page of various functions to add projects, select the default project, and retrieve project information.
#### Authenticate Project
`datature projects auth`
Authenticate new projects using the [project secret key](https://developers.datature.io/v1.0.0/docs/hub-and-api). Multiple projects can be authenticated and stored using different secret keys.
#### Select Project
`datature projects select`
Select an active project to work on from a list of saved projects. All subsequent CLI commands will be in the context of the selected project until a different project is selected, or the shell session is terminated.
```bash
$ datature projects select
> Brain Tumor DICOM
Hand Gesture Keypoint Detection
Your active project is now: [Brain Tumor DICOM]
```
#### List Projects
`datature projects list`
View a table of saved projects with columns containing the names of the projects, the total number of assets, the number of annotated assets, the number of annotations, and the number of tags for each project. The name of the active project is displayed at the bottom of the list.
```bash
$ datature projects list
NAME TOTAL_ASSETS ANNOTATED_ASSETS ANNOTATIONS TAGS
Brain Tumor DICOM 4071 433 1874 3
Hand Gesture Keypoint Detection 718 53 959 4
Your active project is now: [Brain Tumor DICOM]
```
### Asset Management
#### Upload Assets
`datature assets upload`
Upload assets to [Datature Nexus](https://www.datature.io/nexus?utm_source=github). You will be prompted to enter the path to the folder containing the assets that you wish to upload, as well as optional group name(s) to categorize the set of assets. This function is designed specially for bulk uploading of large datasets, which accelerates the process of onboarding data for subsequent annotation and training.
This function also supports DICOM and NIfTI file upload, which caters to important medical use cases.
```bash
$ datature asset upload
[?] Enter the assets folder path to be uploaded: /Downloads/Training2
[?] Enter the assets group name(s), split by ',': main
[?] 281 assets will be uploaded to group(s) (main)? (Y/n):
Preparing |████████████████████████████████████████| 281/281 [100%] in 0.1s (2775.28/s)
Processing |████████████████████████████████████████| 100% [281/281] in 1:17.5 (3.56/s)
Server processing completed.
```
#### Group Assets
`datature assets groups`
List asset group information within your project. You will be prompted to select an existing group or create a new group. If you select an existing group, information about the selected group will be displayed, including the total number of assets in the group, the number of assets that have been annotated, reviewed, or marked for fixes, and the number of assets that have been completed.
```bash
$ datature assets groups
> main
validation
NAME TOTAL ANNOTATED REVIEW TOFIX COMPLETED
main 8 1 0 0 0
```
### Annotation Management
#### Upload Annotations
`datature annotations upload`
Upload annotation files to [Datature Nexus](https://www.datature.io/nexus?utm_source=github) You will be prompted to enter the path of the annotation file you wish to upload and select a [supported annotation format](https://developers.datature.io/docs/uploading-annotations#supported-annotation-formats).
```bash
$ datature annotations upload
[?] Enter the annotation files path to be uploaded: /Users/Downloads/Training.csv
Processing |████████████████████████████████████████| 100% [1/1] in 7.0s (0.14/s)
Server processing completed.
```
#### Download Annotations
`datature annotations download`
Download annotation files from [Datature Nexus](https://www.datature.io/nexus?utm_source=github). You will be prompted to enter a path to save the downloaded annotation file to, and select the desired [annotation format](https://developers.datature.io/docs/uploading-annotations#supported-annotation-formats).
```bash
$ datature annotations download
[?] Enter the annotation files path to be download: /Users/Downloads/
[?] Select the annotation file format: csv_widthheight
csv_fourcorner
> csv_widthheight
coco
pascal_voc
yolo_keras_pytorch
yolo_darknet
polygon_single
polygon_coco
Processing |████████████████████████████████████████| 100% [1/1] in 7.0s (0.14/s)
Server processing completed.
```
### Artifact Management
#### Artifact Download
`datature artifacts download`
Download a model artifact from [Datature Nexus](https://www.datature.io/nexus?utm_source=github). You will be prompted to enter a folder path to save the model to, and select the name and [export format](https://developers.datature.io/docs/export-formats) of the artifact to download.
```bash
$ datature artifacts download
[?] Enter the folder path to save model: /Volumes/
[?] Which artifact do you want to download?: BEAF45-Workflow
> BEAF45-Workflow
[?] Which model format do you want to download?: tensorflow
> TensorFlow
TFLite
ONNX
Downloading |████████████████████████████████████████| 100% [443421394/443421394] in 7.1s (62639992.12/s)
```
## FAQ
### How do I find my Secret Key and Project Key?
We provide a step-by-step guide to finding these two crucial keys in our [Developer's Documentation](https://developers.datature.io/docs/project-keys-and-secret-keys). You can also explore the other sections under [Python SDK](https://developers.datature.io/docs/python-sdk) to learn more about the full functionality and feature set.
### I'm facing some issues, what now?
We're sorry to hear that, please head over to our [Issues](https://github.com/datature/datature-py/issues) page and post a detailed bug report following our guidelines, and we will address your concerns as soon as we can. Alternatively, ping us in our [Community Slack](https://datature.io/community) where our engineers will attend to your needs.
### I've noticed that some features are missing, how do I contribute?
Datature Python SDK is open-source and we welcome everyone to help to improve it. Please check out our [Contributing Guide](CONTRIBUTING.md) to learn how you can be a part of the team.
### How do I resolve the `command not found: datature` error for the CLI?
The `command not found: datature` error indicates that the Datature SDK/CLI tool is not installed properly in your system's PATH, or it has not been installed at all. To resolve this error, please follow these steps:
#### Ensure Datature CLI is Installed
Before anything else, verify that you've installed the Datature CLI. You can install it using pip with the following command:
```bash
pip install datature
```
If you're using a virtual environment (which is recommended), ensure that it's activated before running the installation command.
#### Check Your PATH
After installation, the datature command should be automatically added to your system's PATH. If it's not found, you may need to manually add the directory containing the datature executable to your PATH:
```bash
which datature
```
Or
```bash
pip show datature
```
As expected, it will show the location of the package like this:
```bash
Location: /Users/.pyenv/versions/3.8.18/lib/python3.8/site-packages
```
#### Add the Path to Your Profile
Open your shell profile file with a text editor. This file could be one of ~/.bash_profile, ~/.bashrc, ~/.zshrc, etc., depending on which shell you use and the specific configuration of your operating system.
For example, you can add the path using the following command:
```bash
echo 'export PATH="$PATH:/path/to/datature"' >> ~/.bash_profile
```
Replace /path/to/datature with the actual path you found with which datature or pip show datature.
#### Restart Your Terminal
Sometimes, changes to the PATH environment variable do not take effect until you open a new terminal session. After installation or modification of the PATH, close your current terminal and open a new one, then try the command again.
Raw data
{
"_id": null,
"home_page": "https://datature.io/",
"name": "datature",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Datature",
"author_email": "developers@datature.io",
"download_url": "https://files.pythonhosted.org/packages/16/76/af2d7ef99d89d626e0b344af42f3ccb33c33d292fccb2b514a77018851a6/datature-1.11.4.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n\n# :hammer: Datature Python SDK :hammer:\n\n[](https://pypi.org/project/datature)\n[](https://pypi.org/project/datature)\n[](https://pypi.org/project/datature)\n\n[](https://datature.io/community) [](https://lbesson.apache-license.org/)\n\n<a href=\"https://datature.io\"><img src=\"assets/datature.svg\" width=\"3%\"/></a><img src=\"assets/transparent.png\" width=\"3%\"/>\n<a href=\"https://www.datature.io/blog\"><img src=\"assets/blog.svg\" width=\"3%\"/></a><img src=\"assets/transparent.png\" width=\"3%\"/>\n<a href=\"https://developers.datature.io/\"><img src=\"https://cdn.simpleicons.org/readme/#018EF5\" width=\"3%\"/></a><img src=\"assets/transparent.png\" width=\"3%\"/>\n<a href=\"https://www.youtube.com/channel/UCd3UQZ9piasi0vgfg5xI59w\"><img src=\"https://cdn.simpleicons.org/youtube/#FF0000\" width=\"3%\"/></a><img src=\"assets/transparent.png\" width=\"3%\"/>\n<a href=\"https://www.linkedin.com/company/datature/\"><img src=\"https://cdn.simpleicons.org/linkedin/#0A66C2\" width=\"3%\"/></a><img src=\"assets/transparent.png\" width=\"3%\"/>\n<a href=\"https://twitter.com/DatatureAI\"><img src=\"https://cdn.simpleicons.org/twitter/#1D9BF0\" width=\"3%\"/></a><img src=\"assets/transparent.png\" width=\"3%\"/>\n<a href=\"https://datature.io/community\"><img src=\"assets/slack.png\" width=\"3%\"/></a>\n\n---\n\n:zap: Empower your MLOps pipelines and applications with seamless integrations :zap:\n\nAutomate tasks to manage your datasets, run training experiments, export and deploy your models from [Datature Nexus](https://www.datature.io/nexus?utm_source=github) with ease. Perform development via [Python Scripts](#python-usage) or with the [Command-Line Interface](#cli-usage).\n\n</div>\n\n---\n\n<div align=\"center\">\n\n## Getting Started\n\n</div>\n\n## Prerequisites\n\n- `3.8` <= Python <= `3.12`\n\nWe recommend users to create a virtual environment before installing any dependencies. For more information on virtual environments, please refer to:\n\n- [Python venv](https://docs.python.org/3/tutorial/venv.html)\n- [Conda](https://conda.io/projects/conda/en/stable/user-guide/install/index.html)\n- [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/)\n\n## Installation\n\n```sh\npip install --upgrade datature\n```\n\n---\n\n## Python Usage\n\nFor a full list of documentation and examples, please refer to the [API docs](https://developers.datature.io/docs/python-sdk).\n\n### Authentication\n\nTo get started, you will first need to create a project on [Datature Nexus](https://www.datature.io/nexus?utm_source=github) (you can create sign up for a free account [here](https://nexus.datature.io/)). You will then need to locate the [project secret key](https://developers.datature.io/docs/project-keys-and-secret-keys). This key can only be accessed if you are the Project Owner or have been granted elevated permissions by the Project Owner, and will be used for all subsequent authentication when invoking the various SDK functions.\n\n### Examples\n\nTo list projects:\n\n```python\nfrom datature import nexus\n\nclient = nexus.Client(\"31a9f0dd997cb632765fc0d222369f6106327c3d20719d31f6ffafe51708f117\")\nprojects = client.list_projects()\n```\n\nTo upload assets:\n\n```python\nimport os\nfrom datature import nexus\n\nlogging.basicConfig()\nclient = nexus.Client(\"31a9f0dd997cb632765fc0d222369f6106327c3d20719d31f6ffafe51708f117\")\nproject = client.get_project(\"fca32b1bb15405d1c2bde19fd90b516d\")\n\nupload_session = project.assets.create_upload_session(groups=[\"dataset\"])\nwith upload_session as session:\n session.add_path(\"/Users/dataset\")\nprint(len(upload_session))\n```\n\n### Logging\n\nYou can vary the logging level depending on your task or use case (such as `DEBUG` to provide more insights), but the default `INFO` level is typically best suited for production use.\n\n```python\nimport logging\n\nlogging.basicConfig()\nlogging.getLogger(\"datature-nexus\").setLevel(logging.DEBUG)\n```\n\n---\n\n## CLI Usage\n\nFor a full list of documentation and examples, please refer to the [CLI docs](https://developers.datature.io/docs/cli).\n\n### Authentication\n\nTo get started, you will first need to create a project on [Datature Nexus](https://www.datature.io/nexus?utm_source=github) (you can create sign up for a free account [here](https://nexus.datature.io/)). You will then need to locate the [project secret key](https://developers.datature.io/docs/project-keys-and-secret-keys). This key can only be accessed if you are the Project Owner or have been granted elevated permissions by the Project Owner, and will be used for all subsequent authentication when invoking the various SDK functions.\n\nOnce you have the project secret, you will now be able to make API requests using the CLI by entering the command `datature projects auth`:\n\n```bash\ndatature projects auth\n[?] Enter the project secret: ************************************************\n[?] Make [Your Project Name] the default project? (Y/n): y\n\nAuthentication succeeded.\n```\n\nYou will now be able to run your desired CLI commands as outlined above. To see all possible functions as well as view the required inputs and expected outputs, check out the following documentation.\n\n### Project Management\n\n`datature projects`\n\nShow a help page of various functions to add projects, select the default project, and retrieve project information.\n\n#### Authenticate Project\n\n`datature projects auth`\n\nAuthenticate new projects using the [project secret key](https://developers.datature.io/v1.0.0/docs/hub-and-api). Multiple projects can be authenticated and stored using different secret keys.\n\n#### Select Project\n\n`datature projects select`\n\nSelect an active project to work on from a list of saved projects. All subsequent CLI commands will be in the context of the selected project until a different project is selected, or the shell session is terminated.\n\n```bash\n$ datature projects select\n\n> Brain Tumor DICOM\n Hand Gesture Keypoint Detection\n\nYour active project is now: [Brain Tumor DICOM]\n```\n\n#### List Projects\n\n`datature projects list`\n\nView a table of saved projects with columns containing the names of the projects, the total number of assets, the number of annotated assets, the number of annotations, and the number of tags for each project. The name of the active project is displayed at the bottom of the list.\n\n```bash\n$ datature projects list\n\nNAME TOTAL_ASSETS ANNOTATED_ASSETS ANNOTATIONS TAGS\nBrain Tumor DICOM 4071 433 1874 3\nHand Gesture Keypoint Detection 718 53 959 4\n\nYour active project is now: [Brain Tumor DICOM]\n```\n\n### Asset Management\n\n#### Upload Assets\n\n`datature assets upload`\n\nUpload assets to [Datature Nexus](https://www.datature.io/nexus?utm_source=github). You will be prompted to enter the path to the folder containing the assets that you wish to upload, as well as optional group name(s) to categorize the set of assets. This function is designed specially for bulk uploading of large datasets, which accelerates the process of onboarding data for subsequent annotation and training.\n\nThis function also supports DICOM and NIfTI file upload, which caters to important medical use cases.\n\n```bash\n$ datature asset upload\n[?] Enter the assets folder path to be uploaded: /Downloads/Training2\n[?] Enter the assets group name(s), split by ',': main\n[?] 281 assets will be uploaded to group(s) (main)? (Y/n):\nPreparing |\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 281/281 [100%] in 0.1s (2775.28/s)\nProcessing |\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 100% [281/281] in 1:17.5 (3.56/s)\nServer processing completed.\n```\n\n#### Group Assets\n\n`datature assets groups`\n\nList asset group information within your project. You will be prompted to select an existing group or create a new group. If you select an existing group, information about the selected group will be displayed, including the total number of assets in the group, the number of assets that have been annotated, reviewed, or marked for fixes, and the number of assets that have been completed.\n\n```bash\n$ datature assets groups\n\n> main\n validation\n\nNAME TOTAL ANNOTATED REVIEW TOFIX COMPLETED\nmain 8 1 0 0 0\n```\n\n### Annotation Management\n\n#### Upload Annotations\n\n`datature annotations upload`\n\nUpload annotation files to [Datature Nexus](https://www.datature.io/nexus?utm_source=github) You will be prompted to enter the path of the annotation file you wish to upload and select a [supported annotation format](https://developers.datature.io/docs/uploading-annotations#supported-annotation-formats).\n\n```bash\n$ datature annotations upload\n[?] Enter the annotation files path to be uploaded: /Users/Downloads/Training.csv\nProcessing |\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 100% [1/1] in 7.0s (0.14/s)\nServer processing completed.\n```\n\n#### Download Annotations\n\n`datature annotations download`\n\nDownload annotation files from [Datature Nexus](https://www.datature.io/nexus?utm_source=github). You will be prompted to enter a path to save the downloaded annotation file to, and select the desired [annotation format](https://developers.datature.io/docs/uploading-annotations#supported-annotation-formats).\n\n```bash\n$ datature annotations download\n[?] Enter the annotation files path to be download: /Users/Downloads/\n[?] Select the annotation file format: csv_widthheight\n csv_fourcorner\n > csv_widthheight\n coco\n pascal_voc\n yolo_keras_pytorch\n yolo_darknet\n polygon_single\n polygon_coco\n\nProcessing |\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 100% [1/1] in 7.0s (0.14/s)\nServer processing completed.\n```\n\n### Artifact Management\n\n#### Artifact Download\n\n`datature artifacts download`\n\nDownload a model artifact from [Datature Nexus](https://www.datature.io/nexus?utm_source=github). You will be prompted to enter a folder path to save the model to, and select the name and [export format](https://developers.datature.io/docs/export-formats) of the artifact to download.\n\n```bash\n$ datature artifacts download\n[?] Enter the folder path to save model: /Volumes/\n[?] Which artifact do you want to download?: BEAF45-Workflow\n > BEAF45-Workflow\n\n[?] Which model format do you want to download?: tensorflow\n > TensorFlow\n TFLite\n ONNX\n\nDownloading |\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 100% [443421394/443421394] in 7.1s (62639992.12/s)\n```\n\n## FAQ\n\n### How do I find my Secret Key and Project Key?\n\nWe provide a step-by-step guide to finding these two crucial keys in our [Developer's Documentation](https://developers.datature.io/docs/project-keys-and-secret-keys). You can also explore the other sections under [Python SDK](https://developers.datature.io/docs/python-sdk) to learn more about the full functionality and feature set.\n\n### I'm facing some issues, what now?\n\nWe're sorry to hear that, please head over to our [Issues](https://github.com/datature/datature-py/issues) page and post a detailed bug report following our guidelines, and we will address your concerns as soon as we can. Alternatively, ping us in our [Community Slack](https://datature.io/community) where our engineers will attend to your needs.\n\n### I've noticed that some features are missing, how do I contribute?\n\nDatature Python SDK is open-source and we welcome everyone to help to improve it. Please check out our [Contributing Guide](CONTRIBUTING.md) to learn how you can be a part of the team.\n\n### How do I resolve the `command not found: datature` error for the CLI?\n\nThe `command not found: datature` error indicates that the Datature SDK/CLI tool is not installed properly in your system's PATH, or it has not been installed at all. To resolve this error, please follow these steps:\n\n#### Ensure Datature CLI is Installed\n\nBefore anything else, verify that you've installed the Datature CLI. You can install it using pip with the following command:\n\n```bash\npip install datature\n```\n\nIf you're using a virtual environment (which is recommended), ensure that it's activated before running the installation command.\n\n#### Check Your PATH\n\nAfter installation, the datature command should be automatically added to your system's PATH. If it's not found, you may need to manually add the directory containing the datature executable to your PATH:\n\n```bash\nwhich datature\n```\n\nOr\n\n```bash\npip show datature\n```\n\nAs expected, it will show the location of the package like this:\n\n```bash\nLocation: /Users/.pyenv/versions/3.8.18/lib/python3.8/site-packages\n```\n\n#### Add the Path to Your Profile\n\nOpen your shell profile file with a text editor. This file could be one of ~/.bash_profile, ~/.bashrc, ~/.zshrc, etc., depending on which shell you use and the specific configuration of your operating system.\n\nFor example, you can add the path using the following command:\n\n```bash\necho 'export PATH=\"$PATH:/path/to/datature\"' >> ~/.bash_profile\n```\n\nReplace /path/to/datature with the actual path you found with which datature or pip show datature.\n\n#### Restart Your Terminal\n\nSometimes, changes to the PATH environment variable do not take effect until you open a new terminal session. After installation or modification of the PATH, close your current terminal and open a new one, then try the command again.\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Python bindings for the Datature API",
"version": "1.11.4",
"project_urls": {
"Changelog": "https://developers.datature.io/docs/sdk-changelog",
"Documentation": "https://developers.datature.io/docs/python-sdk",
"Download": "https://pypi.org/project/datature#files",
"Homepage": "https://datature.io/",
"Slack Community": "https://datature.io/community"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "bb49da77cdcb356b0d2bb9263c1a83b59716fd8552989dbf1df943d782177728",
"md5": "09938188a9aec494ec25cefba4b6a9ce",
"sha256": "311dbc6c57e4038d53e35f9c582f3bfbdea41bd3f08b211e0a1f7ed25a56d6f9"
},
"downloads": -1,
"filename": "datature-1.11.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "09938188a9aec494ec25cefba4b6a9ce",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 292887,
"upload_time": "2025-07-16T10:37:58",
"upload_time_iso_8601": "2025-07-16T10:37:58.336823Z",
"url": "https://files.pythonhosted.org/packages/bb/49/da77cdcb356b0d2bb9263c1a83b59716fd8552989dbf1df943d782177728/datature-1.11.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1676af2d7ef99d89d626e0b344af42f3ccb33c33d292fccb2b514a77018851a6",
"md5": "b1150c5e7f5fded11a8d20b647c36f1b",
"sha256": "4dd8d3a887354a8d27cb242594e5db07d3f08685190fcd46a410e0de9ffe5d5b"
},
"downloads": -1,
"filename": "datature-1.11.4.tar.gz",
"has_sig": false,
"md5_digest": "b1150c5e7f5fded11a8d20b647c36f1b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 3543245,
"upload_time": "2025-07-16T10:38:00",
"upload_time_iso_8601": "2025-07-16T10:38:00.342559Z",
"url": "https://files.pythonhosted.org/packages/16/76/af2d7ef99d89d626e0b344af42f3ccb33c33d292fccb2b514a77018851a6/datature-1.11.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-16 10:38:00",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "datature"
}
JSON