<commit_before>---
layout: page
title: Getting started
permalink: /:path/
nav: /:path/Programming-guide/Getting-started/
sort_idx: 10
---

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents**

- [Installation and configuration](#installation-and-configuration)
- [Your first Kaa application](#your-first-kaa-application)
  - [Add application](#add-application)
  - [Create notification schema](#create-notification-schema)
  - [Generate SDK](#generate-sdk)
  - [Sample client application](#sample-client-application)
  - [Create notification topic](#create-notification-topic)
  - [Create notification](#create-notification)
- [Further reading](#further-reading)
- [Attachments:](#attachments)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

This section provides guidance on how to create your first Kaa application that will work with the Kaa platform. In this guide we will show you how to create a simple desktop java application that will receive notifications from the Kaa server and display them on the console. We will define our own notification schema and use the generated java classes within our application.

# Installation and configuration

Before you start using the Kaa framework, you need to install it. You can install Kaa in the [single node](Single-node-installation) mode or [distributed ](../../Administration-guide/System-installation/Cluster-setup)mode. The installation procedure is described in [Installation guide](../../Administration-guide/System-installation).

However, we recommend that you start exploring Kaa using Sandbox. Kaa Sandbox is an easy-to-use virtual environment that includes all the components that you need in order to learn Kaa, build a proof of concept and test your own applications locally. Sandbox also includes demo client applications.

The Sandbox setup procedure is straightforward and can be done instantly. See [Sandbox guide](Sandbox) for details.

# Your first Kaa application

To register a new application within a fresh Kaa server installation, you need to create users with the _tenant administrator_ and _tenant developer_ roles. The tenant administrator is responsible for creating new applications in Kaa, and the tenant developer configures and generates SDKs for those applications. We suggest that you use Kaa Sandbox, which has a tenant administrator and tenant developer users already created.

## Adding application

To add an application, proceed as follows:
<commit_msg>remove unused line in table of contents<commit_after>---
layout: page
title: Getting started
permalink: /:path/
nav: /:path/Programming-guide/Getting-started/
sort_idx: 10
---

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents**

- [Installation and configuration](#installation-and-configuration)
- [Your first Kaa application](#your-first-kaa-application)
  - [Add application](#add-application)
  - [Create notification schema](#create-notification-schema)
  - [Generate SDK](#generate-sdk)
  - [Sample client application](#sample-client-application)
  - [Create notification topic](#create-notification-topic)
  - [Create notification](#create-notification)
- [Further reading](#further-reading)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

This section provides guidance on how to create your first Kaa application that will work with the Kaa platform. In this guide we will show you how to create a simple desktop java application that will receive notifications from the Kaa server and display them on the console. We will define our own notification schema and use the generated java classes within our application.

# Installation and configuration

Before you start using the Kaa framework, you need to install it. You can install Kaa in the [single node](Single-node-installation) mode or [distributed ](../../Administration-guide/System-installation/Cluster-setup)mode. The installation procedure is described in [Installation guide](../../Administration-guide/System-installation).

However, we recommend that you start exploring Kaa using Sandbox. Kaa Sandbox is an easy-to-use virtual environment that includes all the components that you need in order to learn Kaa, build a proof of concept and test your own applications locally. Sandbox also includes demo client applications.

The Sandbox setup procedure is straightforward and can be done instantly. See [Sandbox guide](Sandbox) for details.

# Your first Kaa application

To register a new application within a fresh Kaa server installation, you need to create users with the _tenant administrator_ and _tenant developer_ roles. The tenant administrator is responsible for creating new applications in Kaa, and the tenant developer configures and generates SDKs for those applications. We suggest that you use Kaa Sandbox, which has a tenant administrator and tenant developer users already created.

## Adding application

To add an application, proceed as follows:

{'fraction_non_alphanumeric': 0.07339626276247352, 'fraction_numerical': 0.0007705644384511655, 'mean_word_length': 4.794642857142857, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 9, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1076524', 'n_tokens_mistral': 1281, 'n_tokens_neox': 1199, 'n_words': 629}