Client Setup

Client Installation

The first step in using Kaskada in a notebook is to install the Kaskada Python client package.

!pip install -q grpcio~=1.34.0 kaskada 

Setup "fenlmagic" Extension

IPython supports what it calls "magic commands" - commands prefixed with % or %%, whose implementation may be provided by arbitrary Python code.

Kaskada provides a magic command to improve the Fenl authoring experience.

To use the magic extension you must first install the fenlmagic package in your notebook environment:

!pip install -q fenlmagic

Additional information about client installation can be found here: Reference - Client Installation

Client Authentication

The next step is to connect to Kaskada by logging in to Kaskada's admin page and set up your environment.

To do this, you'll need to obtain your API client id and secret. These may be obtained by logging into Kaskada and navigating to studio.kaskada.com/access. (If you don't have an account, contact us to sign up.)

We recommend using the python getpass method to avoid saving your client id and secret to the notebook:

import os
from getpass import getpass

os.environ["KASKADA_CLIENT_ID"] = getpass("Enter your Kaskada Client ID here: ")
os.environ["KASKADA_CLIENT_SECRET"] = getpass("Enter your Kaskada Client Secret here: ")

When executing this code-block, paste in your client id and secret, and they will be added to the environment without displaying to the screen or saving to the notebook.

Client Initialization

After setting the environment variables, initialize the kaskada client.

import kaskada as kda
kda.init()

If your credentials are valid, this should return no results. If you get an error, check your credentials.

Finally, the fenlmagic extension must be initialized to register the syntax extension with IPython:

%load_ext fenlmagic

Additional information about client authetication can be found here: Reference - Client Authentication