Welcome to the 3LC Quickstart guide! This guide is intended for developers, data scientists, and system administrators who are looking to get started with 3LC.

The video below takes you through the steps in this guide.

Install the 3lc Python Package#

Install 3lc

See the system requirements for supported operating systems and Python versions, as well as PyTorch related prerequisites. Note that the PyPI wheel is named 3lc but the package is imported as tlc in Python code.

pip install 3lc

Start the 3LC Object Service#

The 3LC Object Service facilitates the sharing of samples and metrics between the different client components in 3LC, including your notebooks and the 3LC Dashboard. It needs to be explicitly started from the terminal in order to use 3LC. The Object Service can be terminated by pressing Q from the terminal window.

3lc service

This section demonstrates how to run the Object Service in the common case where you want to run it locally on the same computer where you run training. For advanced scenarios, such as running the Object Service on a remote server, see the Object Service Deployment Guide.

Launch the 3LC Dashboard#

Launch the 3LC Dashboard in a browser at https://dashboard.3lc.ai to explore your data. See the system requirements for supported browsers.

Please check that hardware GPU acceleration is enabled for your browser to get an optimal experience when using the Dashboard.

Next Steps#

With the Object Service and Dashboard running, the next step is to integrate 3LC into your Python Notebooks to gather data and metrics for display in the 3LC Dashboard. For specific implementation examples with popular machine learning frameworks and computer vision workflows, refer to the Example Notebooks. For a comprehensive overview of the entire system, consult the User Guide.

You can also follow our “Getting started with 3LC” playlist of videos, which takes you through an end-to-end example of using 3LC with PyTorch to collect metrics and explore a run in the 3LC Dashboard.