# Clarifai Python Data Utils
[](https://discord.gg/M32V7a7a)
[](https://pypi.org/project/clarifai-datautils)
This is a collection of utilities for handling various types of multimedia data. Enhance your experience by seamlessly integrating these utilities with the Clarifai Python SDK. This powerful combination empowers you to address both visual and textual use cases effortlessly through the capabilities of Artificial Intelligence. Unlock new possibilities and elevate your projects with the synergy of versatile data utilities and the robust features offered by the [Clarifai Python SDK](https://github.com/Clarifai/clarifai-python). Explore the fusion of these tools to amplify the intelligence in your applications! 🌐🚀
[Website](https://www.clarifai.com/) | [Schedule Demo](https://www.clarifai.com/company/schedule-demo) | [Signup for a Free Account](https://clarifai.com/signup) | [API Docs](https://docs.clarifai.com/) | [Clarifai Community](https://clarifai.com/explore) | [Python SDK Docs](https://docs.clarifai.com/python-sdk/api-reference) | [Examples](https://github.com/Clarifai/examples) | [Colab Notebooks](https://github.com/Clarifai/colab-notebooks) | [Discord](https://discord.gg/XAPE3Vtg)
---
## Table Of Contents
* **[Installation](#installation)**
* **[Getting Started](#getting-started)**
* **[Features](#features)**
* [Image Utils](#image-utils)
* **[Usage](#usage)**
* **[Examples](#more-examples)**
## Installation
Install from PyPi:
```bash
pip install clarifai-datautils
```
Install from Source:
```bash
git clone https://github.com/Clarifai/clarifai-python-datautils
cd clarifai-python-datautils
python3 -m venv env
source env/bin/activate
pip3 install -r requirements.txt
```
## Getting started
Quick intro to Image Annotation Conversion feature
```python
from clarifai_datautils import ImageAnnotations
annotated_dataset = ImageAnnotations.import_from(path= 'folder_path', format= 'annotation_format')
```
## Features
### Image Utils
- #### Annotation Loader
- Load various annotated image datasets and export to clarifai Platform
- Convert from one annotation format to other supported annotation formats
## Usage
### Image Annotation Loader
```python
from clarifai_datautils import ImageAnnotations
#import from folder
coco_dataset = ImageAnnotations.import_from(path='folder_path',format= 'coco_detection')
#Using clarifai SDK to upload to Clarifai Platform
#export CLARIFAI_PAT={your personal access token} # set PAT as env variable
from clarifai.client.dataset import Dataset
dataset = Dataset(user_id="user_id", app_id="app_id", dataset_id="dataset_id")
dataset.upload_dataset(dataloader=coco_dataset.dataloader)
#info about loaded dataset
coco_dataset.get_info()
#exporting to other formats
coco_dataset.export_to('voc_detection')
```
## More Examples
See many more code examples in this [repo](https://github.com/Clarifai/examples).
Raw data
{
"_id": null,
"home_page": "https://github.com/Clarifai/clarifai-python-datautils",
"name": "clarifai-datautils",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "Clarifai",
"author_email": "support@clarifai.com",
"download_url": "https://files.pythonhosted.org/packages/33/c3/798e6f63393335b956051178a6e8aef98a0d222d7d34f8cfbcfa02795e1a/clarifai-datautils-0.0.2.tar.gz",
"platform": null,
"description": "\n\n# Clarifai Python Data Utils\n\n\n[](https://discord.gg/M32V7a7a)\n[](https://pypi.org/project/clarifai-datautils)\n\nThis is a collection of utilities for handling various types of multimedia data. Enhance your experience by seamlessly integrating these utilities with the Clarifai Python SDK. This powerful combination empowers you to address both visual and textual use cases effortlessly through the capabilities of Artificial Intelligence. Unlock new possibilities and elevate your projects with the synergy of versatile data utilities and the robust features offered by the [Clarifai Python SDK](https://github.com/Clarifai/clarifai-python). Explore the fusion of these tools to amplify the intelligence in your applications! \ud83c\udf10\ud83d\ude80\n\n[Website](https://www.clarifai.com/) | [Schedule Demo](https://www.clarifai.com/company/schedule-demo) | [Signup for a Free Account](https://clarifai.com/signup) | [API Docs](https://docs.clarifai.com/) | [Clarifai Community](https://clarifai.com/explore) | [Python SDK Docs](https://docs.clarifai.com/python-sdk/api-reference) | [Examples](https://github.com/Clarifai/examples) | [Colab Notebooks](https://github.com/Clarifai/colab-notebooks) | [Discord](https://discord.gg/XAPE3Vtg)\n\n---\n## Table Of Contents\n\n* **[Installation](#installation)**\n* **[Getting Started](#getting-started)**\n* **[Features](#features)**\n * [Image Utils](#image-utils)\n* **[Usage](#usage)**\n* **[Examples](#more-examples)**\n\n\n## Installation\n\n\nInstall from PyPi:\n\n```bash\npip install clarifai-datautils\n```\n\nInstall from Source:\n\n```bash\ngit clone https://github.com/Clarifai/clarifai-python-datautils\ncd clarifai-python-datautils\npython3 -m venv env\nsource env/bin/activate\npip3 install -r requirements.txt\n```\n\n\n## Getting started\n\nQuick intro to Image Annotation Conversion feature\n\n```python\nfrom clarifai_datautils import ImageAnnotations\n\nannotated_dataset = ImageAnnotations.import_from(path= 'folder_path', format= 'annotation_format')\n```\n\n## Features\n\n### Image Utils\n- #### Annotation Loader\n - Load various annotated image datasets and export to clarifai Platform\n - Convert from one annotation format to other supported annotation formats\n\n\n\n## Usage\n### Image Annotation Loader\n```python\nfrom clarifai_datautils import ImageAnnotations\n#import from folder\ncoco_dataset = ImageAnnotations.import_from(path='folder_path',format= 'coco_detection')\n\n#Using clarifai SDK to upload to Clarifai Platform\n#export CLARIFAI_PAT={your personal access token} # set PAT as env variable\nfrom clarifai.client.dataset import Dataset\ndataset = Dataset(user_id=\"user_id\", app_id=\"app_id\", dataset_id=\"dataset_id\")\ndataset.upload_dataset(dataloader=coco_dataset.dataloader)\n\n#info about loaded dataset\ncoco_dataset.get_info()\n\n\n#exporting to other formats\ncoco_dataset.export_to('voc_detection')\n```\n\n## More Examples\n\nSee many more code examples in this [repo](https://github.com/Clarifai/examples).\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Clarifai Data Utils",
"version": "0.0.2",
"project_urls": {
"Homepage": "https://github.com/Clarifai/clarifai-python-datautils"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ccaaef1bb77cfdc21607fa75053fe49754221ea82ed69ead0c05b36c542027e7",
"md5": "e92369b7537b31581aa6369fea9926e0",
"sha256": "3e57c3827ee5857b24b246deaf54804abed0541282c85d516f822c124f280d65"
},
"downloads": -1,
"filename": "clarifai_datautils-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e92369b7537b31581aa6369fea9926e0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 14525,
"upload_time": "2024-03-19T15:50:22",
"upload_time_iso_8601": "2024-03-19T15:50:22.587417Z",
"url": "https://files.pythonhosted.org/packages/cc/aa/ef1bb77cfdc21607fa75053fe49754221ea82ed69ead0c05b36c542027e7/clarifai_datautils-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "33c3798e6f63393335b956051178a6e8aef98a0d222d7d34f8cfbcfa02795e1a",
"md5": "3280aebb09ec468fa71d13d35a3e3e6e",
"sha256": "f38ffa62da58f540d02a1951d46c349bb51b16884dedf400938c8b0020f539bf"
},
"downloads": -1,
"filename": "clarifai-datautils-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "3280aebb09ec468fa71d13d35a3e3e6e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 13331,
"upload_time": "2024-03-19T15:50:24",
"upload_time_iso_8601": "2024-03-19T15:50:24.186086Z",
"url": "https://files.pythonhosted.org/packages/33/c3/798e6f63393335b956051178a6e8aef98a0d222d7d34f8cfbcfa02795e1a/clarifai-datautils-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-19 15:50:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Clarifai",
"github_project": "clarifai-python-datautils",
"github_not_found": true,
"lcname": "clarifai-datautils"
}
JSON
