Installation

​

Requirements

• Make sure pip is installed and up-to-date.
• Use the Workspace settings menu of the Labelbox app to create an API key. Store your key in a safe place, as you cannot view it after it has been created.
• Python: 3.9 - 3.13

​

Install or upgrade SDK

pip install "labelbox[data]"
# or
pip install labelbox

# install latest labelbox version
!pip install labelbox

import labelbox as lb

# Enter your Labelbox API key here
LB_API_KEY = None

# Create Labelbox client
client = lb.Client(api_key=LB_API_KEY)

• The Python SDK GitHub repository
• The most recent update to the Python SDK can be found at: https://github.com/Labelbox/labelbox-python/releases/latest/
• Changelog of recent changes.

​

Authentication

• Save your key to an environment variable:
  shell

  user@machine:~$ export LABELBOX_API_KEY="<your_api_key>"
  user@machine:~$ python3
  
  Then, import and initialize the API Client.
  Python

  import labelbox as lb
  
  client = lb.Client()
  
• Paste your API key directly into your script (not recommended)
  Python

  import labelbox as lb
  
  if __name__ == '__main__':
      API_KEY = "<your_api_key_here>"
      client = lb.Client(API_KEY)