Get started with Kotlin DataFrame in Kotlin Notebook

Kotlin Notebook is an interactive environment
integrated into IntelliJ IDEA, designed for fast, iterative, and visual data exploration with Kotlin.

The Kotlin Notebook plugin transforms IntelliJ IDEA into a powerful data science workspace,
combining Kotlin’s strong language features with live code execution, interactive data exploration, and rich visualizations

It’s perfect for working with Kotlin DataFrame — letting you write code, view results instantly, and refine your analysis step by step.

Create Kotlin Notebook

Make sure the Kotlin Notebook plugin is enabled.
Open an IntelliJ IDEA project (either new or existing).
In the project view, create a new Kotlin Notebook file:
Press Cmd+N or right-click the project tree, then select Kotlin Notebook.

For more details, see
Get started with Kotlin Notebook
on the official Kotlin Documentation website.

Integrate Kotlin DataFrame

In the new notebook file, execute the following cell to add the Kotlin DataFrame library:

%use dataframe

This will load all necessary dependencies, add required imports, and enable rich DataFrame rendering in the notebook.

Specify a version

By default, if no version is specified, the version bundled with the notebook kernel is used.
You can explicitly define the version you want:

%use dataframe(1.0.0)

Or use the latest stable version of Kotlin DataFrame (specified in Kotlin Jupyter descriptors):

%useLatestDescriptors
%use dataframe

Hello World

Let’s create your first Kotlin DataFrame in the notebook — a simple "Hello, World!" style example:

val df = dataFrameOf(
  "name" to listOf("Alice", "Bob"),
  "age" to listOf(25, 30)
)

To display it, run a cell with the DataFrame variable in the last line (or simply a cell containing the variable):

You will see the content of this DataFrame rendered as an interactive table directly in the cell output:

Next Steps

Once you’ve successfully set up Kotlin DataFrame in Kotlin Notebook,
you can move on to the Quickstart Guide which walks you through the basics of working with DataFrames inside a notebook.
For more advanced use cases, explore our collection of
detailed guides and real-world examples, showcasing how Kotlin DataFrame can help with a variety of data tasks.
Discover powerful Kotlin DataFrame Features in Kotlin Notebook that make exploring and understanding your data easier and more effective.

20 May 2025