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 http://labelbox.com/ for more information.

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

Requirements

• Use Python 3.7 or 3.8.
• Create an account by visiting http://app.labelbox.com/.
• Generate an API key.

Installation & authentication

0. 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

1. Install using Python's Pip manager.

pip install labelbox

2. Pass your API key as an environment variable. Then, import and initialize the API Client.

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

from labelbox import Client
client = Client()

Documentation

Visit our docs to learn how to create a project, read through some helpful user guides, and view our API reference.

Repo Organization and Contribution

Please consult CONTRIB.md

Testing

1. Update the Makefile with your staging or 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 staging:

make test-staging

3. To test on prod:

make test-prod

4. 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}