Skip to main content

Labelbox Python API

Project description

Labelbox Python SDK

Labelbox is the enterprise-grade training data solution with fast AI enabled labeling tools, labeling automation, human workforce, data management, a powerful API for integration & SDK for extensibility. Visit Labelbox for more information.

The Labelbox Python API offers a simple, user-friendly way to interact with the Labelbox back-end.

Table of Contents

Requirements

Installation

Prerequisite: Install pip

pip is a package manager for Python. On macOS, you can set it up to use the default python3 install via -

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python3 get-pip.py

If the installation completes with a warning re: pip not being in your path, you'll need to add it by modifying your shell config (.zshrc, .bashrc or similar). You might have to modify the command below depending on the version of python3 on your machine.

export PATH=/Users/<your-macOS-username>/Library/Python/3.8/bin:$PATH

Install SDK locally, using Python's Pip manager

pip3 install -e .

Install dependencies

pip3 install -r requirements.txt

To install dependencies required for data processing modules use:

pip install labelbox[data]

Documentation

Authentication

Labelbox uses API keys to validate requests. You can create and manage API keys on Labelbox. Pass your API key as an environment variable. Then, import and initialize the API Client.

user@machine:~$ export LABELBOX_API_KEY="<your local api key here>"
user@machine:~$ python3

from labelbox import Client
client = Client()
  • Update api_key and endpoint if not using the production cloud deployment
# On prem
client = Client( endpoint = "<local deployment>")

# Local
client = Client(api_key=os.environ['LABELBOX_TEST_API_KEY_LOCAL'], endpoint="http://localhost:8080/graphql")

# Staging
client = Client(api_key=os.environ['LABELBOX_TEST_API_KEY_LOCAL'], endpoint="https://staging-api.labelbox.com/graphql")

Contribution

Please consult CONTRIB.md

Testing

  1. Update the Makefile with your local, staging, prod API key. Ensure that docker has been installed on your system. Make sure the key is not from a free tier account.
  2. To test on local:
user@machine:~$ export LABELBOX_TEST_API_KEY_LOCAL="<your local api key here>"
make test-local  # with an optional flag: PATH_TO_TEST=tests/integration/...etc LABELBOX_TEST_API_KEY_LOCAL=specify_here_or_export_me
  1. To test on staging:
user@machine:~$ export LABELBOX_TEST_API_KEY_STAGING="<your staging api key here>"
make test-staging # with an optional flag: PATH_TO_TEST=tests/integration/...etc LABELBOX_TEST_API_KEY_STAGING=specify_here_or_export_me
  1. To test on prod:
user@machine:~$ export LABELBOX_TEST_API_KEY_PROD="<your prod api key here>"
make test-prod # with an optional flag: PATH_TO_TEST=tests/integration/...etc LABELBOX_TEST_API_KEY_PROD=specify_here_or_export_me
  1. If you make any changes and need to rebuild the image used for testing, force a rebuild with the -B flag
make -B {build|test-staging|test-prod}

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

labelbox-3.4.0.tar.gz (95.4 kB view details)

Uploaded Source

Built Distribution

labelbox-3.4.0-py3-none-any.whl (127.2 kB view details)

Uploaded Python 3

File details

Details for the file labelbox-3.4.0.tar.gz.

File metadata

  • Download URL: labelbox-3.4.0.tar.gz
  • Upload date:
  • Size: 95.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.6

File hashes

Hashes for labelbox-3.4.0.tar.gz
Algorithm Hash digest
SHA256 ac00e6dba05408748a0694fb04ce26611f10f5ed912f46f2f97518245a165ae6
MD5 c5e387570f62d1bbf685244fe90bca7d
BLAKE2b-256 91439e073c9320e3ab12e79dfa351bf6954c14f3bfa251cd59b680cb32438ac8

See more details on using hashes here.

File details

Details for the file labelbox-3.4.0-py3-none-any.whl.

File metadata

  • Download URL: labelbox-3.4.0-py3-none-any.whl
  • Upload date:
  • Size: 127.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.6

File hashes

Hashes for labelbox-3.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1f88a029d208a512e65549808494cda12ad798557fdd9be074edc9f2cd0d33f7
MD5 fb1bd94b8e35180292a3095e2ad7f653
BLAKE2b-256 015bb9118b1e2755f27927a8c2fc073aafce7cd6282e3185df8a5326686ce017

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page