# Hyperparameter tuning

When you train a deep-learning model for the first time, it's very likely that its performances are not optimal. 

That's because the training of a model depends on a lot of parameters (also called **hyperparameters**) that you will have to tune in order to find the best combination that optimize the performances of your model.

The first step needed to understand why your model performs the way it does is experiment tracking and if you haven't heard of it or don't know how to do it using Picsellia, we suggest you to follow the following tutorials 👇

{% content-ref url="/pages/-Ma2b8QDfI9VcM9ZLS8w" %}
[Experiment Tracking](/picsellia/experiment-tracking.md)
{% endcontent-ref %}

From now, we will assume that you know how to track your experiments properly, now let's get to the fun part : **Hyperparameter Tuning** 🎉

At Picsellia, we have developed and engine that allows you to perform hyperparameter tuning easily, we call it **Scans.**

To learn the basics of Scans and what you can do with it, follow the next link 👇

{% content-ref url="/pages/-MZrttiBjFofeJ706Oth" %}
[Overview](/picsellia/hyperparameter-tuning/overview.md)
{% endcontent-ref %}

If you want to run Scans on your local machine or your servers, please check our CLI below 👇

{% content-ref url="/pages/-MZlOCtxS4fnjuHHvgl2" %}
[Install Picsell CLI](/picsellia/hyperparameter-tuning/install-picsell-cli.md)
{% endcontent-ref %}

The only thing that you have to do before running Scans is to write its configuration so you can control what will happen very precisely, to see the detailed documentation for the Scan's config 👇

{% content-ref url="/pages/-MZCMWp1OGSz4ET7Vbt5" %}
[Config](/picsellia/hyperparameter-tuning/config.md)
{% endcontent-ref %}

Finally, now that everything should be setup, let's launch the Scans 🚀👇

{% content-ref url="/pages/-MZqJGvLbTONUdn4BE15" %}
[Launch your Hyperparameters tuning](/picsellia/hyperparameter-tuning/launch-your-hyperparameters-tuning.md)
{% endcontent-ref %}


---

# 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://picsellia.gitbook.io/picsellia/hyperparameter-tuning.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.