> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# launch_add

<Card title="Afficher le code source" href="https://www.github.com/wandb/wandb/tree/v0.20.1/wandb/sdk/launch/_launch_add.py#L34-L131" icon="code" />

Ajoute une expérience W\&B Launch à une file d'attente, à partir d'une URI source, d'un job ou d'une docker\_image.

```python theme={"system"}
launch_add(
    uri: Optional[str] = None,
    job: Optional[str] = None,
    config: Optional[Dict[str, Any]] = None,
    template_variables: Optional[Dict[str, Union[float, int, str]]] = None,
    project: Optional[str] = None,
    entity: Optional[str] = None,
    queue_name: Optional[str] = None,
    resource: Optional[str] = None,
    entry_point: Optional[List[str]] = None,
    name: Optional[str] = None,
    version: Optional[str] = None,
    docker_image: Optional[str] = None,
    project_queue: Optional[str] = None,
    resource_args: Optional[Dict[str, Any]] = None,
    run_id: Optional[str] = None,
    build: Optional[bool] = (False),
    repository: Optional[str] = None,
    sweep_id: Optional[str] = None,
    author: Optional[str] = None,
    priority: Optional[int] = None
) -> "public.QueuedRun"
```

| Arguments | Description |
| :- | :- |
| `uri` | URI de l’expérience à exécuter. Un URI de run wandb ou un URI de dépôt Git. |
| `job` | Référence (string) à un wandb.Job, par exemple : wandb/test/my-job:latest |
| `config` | Un dictionnaire contenant la configuration du run. Peut également contenir des arguments propres à la ressource sous la clé "resource\_args" |
| `template_variables` | Un dictionnaire contenant les valeurs des variables de modèle pour une file d’attente de run. Format attendu : `{"VAR_NAME": VAR_VALUE}` |
| `project` | Projet cible auquel envoyer le run lancé |
| `entity` | entity cible à laquelle envoyer le run lancé |
| `queue` | Le nom de la file d’attente dans laquelle placer le run |
| `priority` | Le niveau de priorité du job, 1 étant la priorité la plus élevée |
| `resource` | Backend d’exécution du run : W\&B prend en charge nativement le backend "local-container" |
| `entry_point` | Point d’entrée à exécuter dans le projet. Par défaut, le point d’entrée du run d’origine est utilisé pour les URI wandb, et main.py pour les URI de dépôt Git. |
| `name` | Nom sous lequel lancer le run. |
| `version` | Pour les projets basés sur Git, un hash de commit ou un nom de branche. |
| `docker_image` | Le nom de l’image Docker à utiliser pour le run. |
| `resource_args` | Arguments liés à la ressource pour lancer des runs sur un backend distant. Ils sont stockés dans la configuration de lancement générée, sous `resource_args`. |
| `run_id` | String facultative indiquant l’identifiant du run lancé |
| `build` | Indicateur facultatif, false par défaut ; nécessite que la file d’attente soit définie. Si build est activé, une image est créée, un artifact de job est créé et une référence à cet artifact de job est téléversée dans la file d’attente |
| `repository` | String facultative permettant de définir le nom du dépôt distant, utilisée lors du téléversement d’images vers un registre |
| `project_queue` | String facultative permettant de définir le nom du projet de la file d’attente. Principalement utilisée pour la rétrocompatibilité avec les files d’attente limitées à un projet |

<h4 id="example">
  Exemple :
</h4>

```python theme={"system"}
from wandb.sdk.launch import launch_add

project_uri = "https://github.com/wandb/examples"
params = {"alpha": 0.5, "l1_ratio": 0.01}
# Exécuter le projet W&B et créer un environnement Docker reproductible
# sur un hôte local
api = wandb.apis.internal.Api()
launch_add(uri=project_uri, parameters=params)
```

| Renvoie | Description |
| :- | :- |
| une instance de`wandb.api.public.QueuedRun` qui fournit des informations sur le run en file d'attente ou, si `wait_until_started` ou `wait_until_finished` sont appelées, donne accès aux informations du run sous-jacent. | |

| Exceptions levées | Description |
| :- | :- |
| `wandb.exceptions.LaunchError` en cas d'échec | |