3LC-with-Colab.ipynb

{
  "cells": [
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "PVWi19Dfv9Fi"
      },
      "source": [
        "# Using 3LC with Google Colab\n",
        "\n",
        "[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/3lc-ai/3lc-with-colab/blob/develop/3LC-with-Colab.ipynb)\n",
        "\n",
        "This notebook demonstrates how to use [3LC](https://3lc.ai) with Google Colab in order to inspect, understand, and refine your training data.\n",
        "\n",
        "**Be aware that the usage of 3LC on Colab requires a paid plan. This guide both sets up a reverse proxy as well and uses a web UI to access the the notebook. These practices are [explicitly prohibited](https://research.google.com/colaboratory/faq.html#disallowed-activities) on the free Google Colab plan.**\n",
        "\n",
        "## Prerequisites\n",
        "\n",
        "In order to follow this guide, you should already have recieved the following secrets:\n",
        "\n",
        "- 3LC PyPi Username, referred to as `TLC_USERNAME`\n",
        "- 3LC PyPi Password, referred to as  `TLC_PASSWORD`\n",
        "- 3LC License Key, referred to as  `TLC_LICENSE`\n",
        "- NGrok Token, referred to as  `NGROK_TOKEN`\n",
        "\n",
        "## Setup Colab Secrets\n",
        "\n",
        "We will use the Colab Secrets functionality to store these secrets, so that we avoid having to expose them in the notebook.\n",
        "\n",
        "1. Click on the \"Key\"-icon in the left-side toolbar to bring up the settings dialog.\n",
        "2. Enter the \"Name\" and \"Value\" into the corresponding field. Making sure that the values are entered correctly.\n",
        "3. Enable the \"Notebook access\"-slider on these tokens, so that the notebook can access them.\n",
        "\n",
        "The Secrets dialog should now look like this:\n",
        "\n",
        "![image.png](data:image/png;base64,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)\n",
        "\n",
        "See [this guide](https://labs.thinktecture.com/secrets-in-google-colab-the-new-way-to-protect-api-keys/) for more details on how to use Secrets.\n",
        "\n",
        "\n",
        "\n",
        "\n"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {
        "id": "NSJbPc1V6hDf"
      },
      "source": [
        "## Installing the 3LC Package\n",
        "1. **Execute the Installation Command**: In the cell blow, we will use the ! operator to execute a shell command within the Colab notebook. This command utilizes pip to install additional packages required by the 3LC service into your Colab environment. Please evaluate cell as it is. **Notice that the cell will ask you for access to the secrets that were set above. Please grant this access.**\n",
        "\n",
        "2. **Installation Time**: Be prepared for the installation process to download and install a significant number of packages. This process may take several minutes, depending on the speed of your internet connection and the Colab server's response time.\n",
        "\n",
        "### Restart the Session\n",
        "\n",
        "- **Monitor for Session Restart Requirement**: The installation might update versions of Python packages that were previously installed in your Colab environment. After the installation completes, if you see a \"Restart Session\" button at the bottom of the output window, it indicates that these updates require a session restart to take effect.\n",
        "\n",
        "- **How to Restart**: Click the \"Restart Session\" button. This action will refresh the Colab environment, incorporating the updates made by the package installation.\n",
        "\n",
        "- **Post-Restart Action**: After the session restarts, it's essential to re-evalluate all cells in your notebook. There's no need to rerun the installation command, but unless the installation cell is at the very top, cells above might have to be re-executed.\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": null,
      "metadata": {
        "id": "uIXw-7Hkv_Xm"
      },
      "outputs": [],
      "source": [
        "# Install 3LC and PyNGrok dependency\n",
        "from google.colab import userdata\n",
        "import os\n",
        "\n",
        "# Fetch secrets to we can use them to access the 3LC PyPi repository\n",
        "tlc_username = userdata.get('TLC_USERNAME')\n",
        "tlc_password = userdata.get('TLC_PASSWORD')\n",
        "tlc_license = userdata.get('TLC_LICENSE')\n",
        "ngrok_token = userdata.get('NGROK_TOKEN')\n",
        "\n",
        "# Install\n",
        "!pip install --index-url https://{tlc_username}:{tlc_password}@pypi.3lc.ai/repositories/releases --extra-index-url https://pypi.org/simple tlc-enterprise>=2.2.15 tlc[umap] pyngrok\n",
        "\n",
        "# Create launcher script\n",
        "\n",
        "launcher_script = f\"\"\"\n",
        "#!/bin/sh\n",
        "export TLC_LICENSE={tlc_license}\n",
        "export NGROK_TOKEN={ngrok_token}\n",
        "3lc --verbose service --with-public-examples --dashboard --ngrok\n",
        "\"\"\"\n",
        "\n",
        "filename = 'launch_3lc.sh'\n",
        "\n",
        "# Using 'with' automatically takes care of file closing\n",
        "with open(filename, \"w\") as file:\n",
        "    file.write(launcher_script)\n",
        "\n",
        "# Set the executable bit for the script\n",
        "os.chmod(filename, os.stat(filename).st_mode | os.X_OK)\n"
      ]
    },
    {
      "cell_type": "markdown",
      "source": [
        "## Launch the 3LC Object Service\n",
        "\n",
        "\n",
        "To launch the 3LC object service from Colab, we'll utilize the terminal, which is accessible in the following way:\n",
        "\n",
        "1. **Access the Terminal** : Locate and click on the terminal icon situated at the bottom left corner of the Colab interface. This action will reveal a terminal window on the right side of your screen.\n",
        "\n",
        "2. **Execute the Launch Command**: In the terminal window that appears, type and execute the command `./launch_3lc.sh`. Make sure to include the ./ prefix if the script is located in the current working directory and is meant to be executed from there.\n",
        "\n",
        "3. **Identify the NGrok Dashboard URL**: After running the command, sift through the output to find a line that resembles the following:\n",
        "```\n",
        "[03/07 12:22:10 tlc.service.object_service]: NGrok Dashboard URL: <URL>\n",
        "```\n",
        "This URL points to the NGrok Dashboard, which is instrumental for accessing the 3LC Object Service. We are aware that it might be hard to find this line, this will be improved in a future release of 3lc.\n",
        "\n",
        "4. **Access the Service**: Copy the URL provided in the output and paste it into your web browser's address bar.\n",
        "  1. If you are on a free NGrok account, you will first get a disclaimer page  from NGrok which you have to click through.\n",
        "  2. Vistiing this site will take you to the 3LC Object Service hosted on Colab, where you can explore some example data. Remember, the URL is session-specific and will change with each new Colab session.\n",
        "\n",
        "5. **Stop the Object Service**: The 3LC Object Service can be stopped by pressing `ctrl-c` in the terminal window.\n"
      ],
      "metadata": {
        "id": "vhA88xozkhf0"
      }
    },
    {
      "cell_type": "markdown",
      "source": [
        "## Using 3LC with your own Notebooks\n",
        "\n",
        "To integrate 3LC into your own notebook, follow the steps below:\n",
        "\n",
        "1. **Install 3LC**: Refer to the [Installing 3LC Package](#Installing-the-3LC-Package) section for detailed instructions on how to install the 3LC package in your notebook environment. Ensure you follow each step carefully to successfully install the package.\n",
        "\n",
        "2. **Launch the 3LC Service**: After installation, you need to start the 3LC service to enable its functionality within your notebook. Open your terminal and execute the `./launch_3lc.sh` script. This script initializes the 3LC service, making it ready for use with your notebooks.\n"
      ],
      "metadata": {
        "id": "JydEoad6mRdw"
      }
    },
    {
      "cell_type": "markdown",
      "source": [
        "# Troubleshooting\n",
        "\n",
        "## I am getting `unreconized arguments: --ngrok`\n",
        "\n",
        "You have a too old version of 3lc. Please ensure that your version of `tlc` is at least 2.2.65 and `tlc-enterprise` is at least 2.2.15.\n"
      ],
      "metadata": {
        "id": "shgQlG5d93FU"
      }
    }
  ],
  "metadata": {
    "colab": {
      "provenance": []
    },
    "kernelspec": {
      "display_name": "Python 3 (ipykernel)",
      "language": "python",
      "name": "python3"
    },
    "language_info": {
      "codemirror_mode": {
        "name": "ipython",
        "version": 3
      },
      "file_extension": ".py",
      "mimetype": "text/x-python",
      "name": "python",
      "nbconvert_exporter": "python",
      "pygments_lexer": "ipython3",
      "version": "3.11.7"
    }
  },
  "nbformat": 4,
  "nbformat_minor": 0
}