# Advanced debugging

## Introduction

In this tutorial we are going to show you how to run application in debug mode and interact with it from Supervisely platform

***

## Prepare environment

**Step 1.** Prepare `~/supervisely.env` file with credentials. [Learn more here.](https://github.com/supervisely/developer-portal/blob/main/app-development/getting-started/basics-of-authentication.md#use-.env-file-recommended)

**Step 2.** Clone [repository](https://github.com/supervisely-ecosystem/integrate-inst-seg-model) with source code and demo data and create [Virtual Environment](https://docs.python.org/3/library/venv.html).

```bash
git clone https://github.com/supervisely-ecosystem/integrate-inst-seg-model
cd integrate-inst-seg-model
./create_venv.sh
```

**Step 3.** Install [wireguard-tools](https://www.wireguard.com/install/)

```bash
sudo apt-get install wireguard iproute2
```

**Step 4.** Open repository directory in Visual Studio Code.

```bash
code -r .
```

**Step 5.** Change `TEAM_ID` of `"Advanced mode for Supervisely Team"` configuration in `.vscode/launch.json` file by copying the ID from the context menu of the team. A new debug app session will be created for the team you define:

```python
{
    "name": "Advanced mode for Supervisely Team",
    ***
    "env": {
        ***
        "TEAM_ID": "7", // ⬅️ change value
        ***
    }
}
```

**Step 6.** Copy contents of `my_model` directory to `results` and download model weights.

```bash
mkdir -p results/model
cp -R my_model/* results/model
cd results/model
./init.sh
cd ../..
```

***

## Run debug

**Step 1.** Go to `Run and Debug` section `(Ctrl+Shift+D)`.

**Step 2.** Select `Advanced mode for Supervisely Team` from configuration dropdown

**Step 3.** Press green triangle or `F5` to start debugging. You should see `Debug task has been successfully created: 12345` or `Debug task already exists: 12345` message in console logs.

{% hint style="info" %}
If you need to debug SDK, you can clone Supervisely repository and create a Symbolic Link to it inside your project.

```bash
cd *your_desired_dir*
git clone git@github.com:supervisely/supervisely.git
cd back to project
ln -s *your_desired_dir*/supervisely/supervisely ./supervisely
```

{% endhint %}

***

## Interact with app from Supervisely platform

**Step 1.** Go to Supervisely platform

* [Community Edition](https://app.supervisely.com/)
* [Dev Edition](https://dev.supervisely.com/)
* Or your enterprise platform

**Step 2.** Select `App sessions` from start menu. You will see a list of applications. Find app named `Develop and Debug` and click on sessions button. There you should see your debug app session with the same `ID` as in **Step 3** of previous section.

**Step 3.** Now you can try the app. Choose any project or create new one e.g. [Demo Images](https://dev.supervisely.com/ecosystem/projects/demo-images). Open dataset in `Basic image labeling toolbox`.

**Step 4.** Run `NN Image Labeling` app from the list and connect to your app session. Press `Apply model to image` button `(Ctrl+m)`. Predictions are loaded and added to image automatically without need to refresh the page.

**Step 5.** You can control the execution of the application with any debugging instrument such as breakpoints.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.supervisely.com/app-development/advanced/advanced-debugging.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.