# The Official Open-Source Labelbox <> Pandas Python Integration
[Labelbox](https://labelbox.com/) enables teams to maximize the value of their unstructured data with its enterprise-grade training data platform. For ML use cases, Labelbox has tools to deploy labelers to annotate data at massive scale, diagnose model performance to prioritize labeling, and plug in existing ML models to speed up labeling. For non-ML use cases, Labelbox has a powerful catalog with auto-computed similarity scores that users can use add metadata tags to large amounts of data with a couple clicks.
[Pandas](https://pandas.pydata.org/) stands as the premier open-source Python library for handling CSV and tabluar data and as one of the most widely used Python libraries in the world.
This GitHub repo stands as an open-source Python library, moderated by the Labelbox Solutions team, in facilitating Labelbox users in uploading data to Labelbox and retreiving data from Labelbox in tabular / CSV format using Pandas.
We strongly encourage collaboration - please free to fork this repo and tweak the code base to work for you own data, and make pull requests if you have suggestions on how to enhance the overall experience, add new features, or improve general performance.
Please report any issues/bugs via [Github Issues](https://github.com/Labelbox/labelpandas/issues).
## Table of Contents
* [Requirements](#requirements)
* [Setup](#setup)
* [Example Notebooks](#example-notebooks)
## Requirements
* [Labelbox account](http://app.labelbox.com/)
* [Generate a Labelbox API key](https://docs.labelbox.com/reference/create-api-key)
## Setup
Set up LabelPandas with the following lines of code:
```
!pip install labelpandas -q
import labelpandas as lp
api_key = "" # Insert your Labelbox API key here
client = lp.Client(api_key)
```
Once set up, you can run the following core functions:
- `client.create_data_rows_from_table()` : Creates Labelbox data rows (and metadata) given a Pandas table
- `client.export_to_table()` : Exports labels (and metadata) from a given Labelbox project and creates a Pandas DataFrame
## Example Notebooks
### Importing Data from a CSV
| Notebook | Github | Google Colab |
| ------------------------------ | -------- | ----------------- |
| Basics: Data Rows from URLs | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/urls.ipynb) | [](https://colab.research.google.com/drive/1bxaWWPYGZnvGfFbHyYAX-pgn6kVMHP7q) |
| Data Rows from Raw Text* | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/raw-text.ipynb) | [](https://colab.research.google.com/drive/1Xg-kn6BaYRLl-F4bMJVVopLmgEyQRTTk) |
| Data Rows from Local Files | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/local-files.ipynb) | [](https://colab.research.google.com/drive/1oMEenCfGl19MtRfHdCNdsjGxwDqlo085) |
| Data Rows with Metadata | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/metadata.ipynb) | [](https://colab.research.google.com/drive/1XSaiJlER0cC0yiekCg1eb9CuQw7lPOTL) |
| Data Rows with Attachments | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/attachments.ipynb) | [](https://colab.research.google.com/drive/1JuT867kb7ZwbaYYJYSRVQYf58-0GjSzf) |
| Data Rows with Annotations | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/annotations.ipynb) | [](https://colab.research.google.com/drive/14NMlKInqaI0sP9MqlPaCN1we5pRnWmX3) |
| Putting it all Together | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/full-import.ipynb) | [](https://colab.research.google.com/drive/1MTLXL32JFGgXV1btgq-1VkGuu7U9Un_n) |
------
### Exporting Data to a CSV
| Notebook | Github | Google Colab |
| ------------------------------ | -------- | ----------------- |
| Exporting Data to a CSV | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/export.ipynb) | [](https://colab.research.google.com/drive/135zZ3ardJKzZq4nD_ynpwdgwGtpARhht) |
------
* = Coming soon
Raw data
{
"_id": null,
"home_page": "https://github.com/Labelbox/labelpandas",
"name": "labelpandas",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Labelbox",
"author_email": "raphael@labelbox.com",
"download_url": "https://files.pythonhosted.org/packages/70/f9/97b3ffcc64242004a13f7b2e8d4ba81f572ab61e47fdb008a0b3880ed406/labelpandas-0.1.38.tar.gz",
"platform": null,
"description": "# The Official Open-Source Labelbox <> Pandas Python Integration\n\n[Labelbox](https://labelbox.com/) enables teams to maximize the value of their unstructured data with its enterprise-grade training data platform. For ML use cases, Labelbox has tools to deploy labelers to annotate data at massive scale, diagnose model performance to prioritize labeling, and plug in existing ML models to speed up labeling. For non-ML use cases, Labelbox has a powerful catalog with auto-computed similarity scores that users can use add metadata tags to large amounts of data with a couple clicks.\n\n[Pandas](https://pandas.pydata.org/) stands as the premier open-source Python library for handling CSV and tabluar data and as one of the most widely used Python libraries in the world.\n\nThis GitHub repo stands as an open-source Python library, moderated by the Labelbox Solutions team, in facilitating Labelbox users in uploading data to Labelbox and retreiving data from Labelbox in tabular / CSV format using Pandas. \n\nWe strongly encourage collaboration - please free to fork this repo and tweak the code base to work for you own data, and make pull requests if you have suggestions on how to enhance the overall experience, add new features, or improve general performance. \n\nPlease report any issues/bugs via [Github Issues](https://github.com/Labelbox/labelpandas/issues).\n\n## Table of Contents\n\n* [Requirements](#requirements)\n* [Setup](#setup)\n* [Example Notebooks](#example-notebooks)\n\n## Requirements\n\n* [Labelbox account](http://app.labelbox.com/)\n* [Generate a Labelbox API key](https://docs.labelbox.com/reference/create-api-key)\n\n## Setup\n\nSet up LabelPandas with the following lines of code:\n\n```\n!pip install labelpandas -q\nimport labelpandas as lp\n\napi_key = \"\" # Insert your Labelbox API key here\nclient = lp.Client(api_key)\n```\n\nOnce set up, you can run the following core functions:\n\n- `client.create_data_rows_from_table()` : Creates Labelbox data rows (and metadata) given a Pandas table\n\n- `client.export_to_table()` : Exports labels (and metadata) from a given Labelbox project and creates a Pandas DataFrame\n\n## Example Notebooks\n\n### Importing Data from a CSV\n\n| Notebook | Github | Google Colab |\n| ------------------------------ | -------- | ----------------- |\n| Basics: Data Rows from URLs | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/urls.ipynb) | [](https://colab.research.google.com/drive/1bxaWWPYGZnvGfFbHyYAX-pgn6kVMHP7q) |\n| Data Rows from Raw Text* | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/raw-text.ipynb) | [](https://colab.research.google.com/drive/1Xg-kn6BaYRLl-F4bMJVVopLmgEyQRTTk) |\n| Data Rows from Local Files | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/local-files.ipynb) | [](https://colab.research.google.com/drive/1oMEenCfGl19MtRfHdCNdsjGxwDqlo085) |\n| Data Rows with Metadata | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/metadata.ipynb) | [](https://colab.research.google.com/drive/1XSaiJlER0cC0yiekCg1eb9CuQw7lPOTL) |\n| Data Rows with Attachments | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/attachments.ipynb) | [](https://colab.research.google.com/drive/1JuT867kb7ZwbaYYJYSRVQYf58-0GjSzf) |\n| Data Rows with Annotations | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/annotations.ipynb) | [](https://colab.research.google.com/drive/14NMlKInqaI0sP9MqlPaCN1we5pRnWmX3) |\n| Putting it all Together | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/full-import.ipynb) | [](https://colab.research.google.com/drive/1MTLXL32JFGgXV1btgq-1VkGuu7U9Un_n) |\n------\n\n### Exporting Data to a CSV\n\n| Notebook | Github | Google Colab |\n| ------------------------------ | -------- | ----------------- |\n| Exporting Data to a CSV | [](https://github.com/Labelbox/labelpandas/blob/main/notebooks/export.ipynb) | [](https://colab.research.google.com/drive/135zZ3ardJKzZq4nD_ynpwdgwGtpARhht) |\n------\n\n* = Coming soon\n",
"bugtrack_url": null,
"license": "",
"summary": "Labelbox Connector for Pandas",
"version": "0.1.38",
"project_urls": {
"Homepage": "https://github.com/Labelbox/labelpandas"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b2b6fda8197fbadea3ff9714cea57d1ee2505eb53fa3d624fe7b1ce06d7cb26b",
"md5": "57d828a121419c8c7211e8a58fa083de",
"sha256": "0314a48bc7d626612c9d7c51339b1e9d5440761e5c9397d179e9654fccab6755"
},
"downloads": -1,
"filename": "labelpandas-0.1.38-py3-none-any.whl",
"has_sig": false,
"md5_digest": "57d828a121419c8c7211e8a58fa083de",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 12472,
"upload_time": "2023-08-02T18:46:52",
"upload_time_iso_8601": "2023-08-02T18:46:52.414827Z",
"url": "https://files.pythonhosted.org/packages/b2/b6/fda8197fbadea3ff9714cea57d1ee2505eb53fa3d624fe7b1ce06d7cb26b/labelpandas-0.1.38-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "70f997b3ffcc64242004a13f7b2e8d4ba81f572ab61e47fdb008a0b3880ed406",
"md5": "65339c43e92c774b3e45947008e4f715",
"sha256": "3d1e2a7a8a84831e37a7e9104bbe240886fde6742d8277467d6f1a3bea1335cb"
},
"downloads": -1,
"filename": "labelpandas-0.1.38.tar.gz",
"has_sig": false,
"md5_digest": "65339c43e92c774b3e45947008e4f715",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 12429,
"upload_time": "2023-08-02T18:46:53",
"upload_time_iso_8601": "2023-08-02T18:46:53.411400Z",
"url": "https://files.pythonhosted.org/packages/70/f9/97b3ffcc64242004a13f7b2e8d4ba81f572ab61e47fdb008a0b3880ed406/labelpandas-0.1.38.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-02 18:46:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Labelbox",
"github_project": "labelpandas",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "labelpandas"
}
JSON
