> ## 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.

# login()

export const GitHubLink = ({url, compact = false}) => <a href={url} target="_blank" rel="noopener noreferrer" className={compact ? "source-link" : "github-source-link"}>
    {compact ? "View source" : <>
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z" />
    </svg>
    GitHub source
      </>}
  </a>;

<GitHubLink compact url="https://github.com/wandb/wandb/blob/main/wandb/sdk/wandb_login.py#L20" />

<h2 id="function-wandblogin">
  <Badge color="blue" size="lg" shape="rounded">function</Badge> wandb.login()
</h2>

Se connecter à W\&B.

En règle générale, vous n'avez pas besoin d'utiliser cette fonction, car la plupart des méthodes W\&B qui nécessitent
une authentification peuvent se connecter implicitement. Il s'agit de l'équivalent programmatique
de la commande CLI `wandb login`.

Cette fonction met à jour les identifiants d’authentification globaux de la session (ce qui affecte toute utilisation de wandb
dans le processus Python en cours après cet appel) et, le cas échéant, le fichier .netrc.

Si un fichier de jeton d’identité est configuré, par exemple via la
variable d’environnement WANDB\_IDENTITY\_TOKEN\_FILE, ce jeton est utilisé pour la
session (identité fédérée) et aucune clé API n’est lue ni enregistrée.

Sinon, si une clé API est explicitement fournie, elle est utilisée et écrite dans
le fichier .netrc du système. Si aucune clé n’est fournie, mais que la session est déjà
authentifiée, la clé de la session est utilisée pour la vérification (si verify
vaut True) et le fichier .netrc n’est pas mis à jour.

Si aucune de ces conditions n’est remplie, la clé API est récupérée à partir de la première source disponible parmi les suivantes :

* La variable d’environnement WANDB\_API\_KEY
* Le paramètre api\_key dans un fichier de paramètres du système ou du workspace
* Le fichier .netrc (\~/.netrc, \~/\_netrc ou le chemin indiqué par la
  variable d’environnement NETRC)
* Une invite interactive, si elle est disponible et si `prompt` vaut True

```python theme={"system"}
key: 'str | None' = None,
relogin: 'bool | None' = None,
host: 'str | None' = None,
force: 'bool | None' = None,
timeout: 'int | None' = None,
verify: 'bool' = True,
referrer: 'str | None' = None,
prompt: 'bool' = True,
anonymous: 'DoNotSet' = DoNotSet
```

<h2 id="args">
  Arguments
</h2>

<ResponseField name="key" type="str | None">
  La clé API à utiliser.
</ResponseField>

<ResponseField name="relogin" type="bool | None">
  Si true, obtient la clé API via une invite interactive, sans lire le fichier .netrc, les variables d’environnement, etc.
</ResponseField>

<ResponseField name="host" type="str | None">
  L’URL du serveur W\&B auquel se connecter.
</ResponseField>

<ResponseField name="force" type="bool | None">
  Si true, empêche de sélectionner le mode hors ligne dans l’invite interactive.
</ResponseField>

<ResponseField name="timeout" type="int | None">
  Délai d’attente, en secondes, de la saisie de l’utilisateur dans l’invite interactive. Ce paramètre peut servir de garde-fou si une invite interactive s’affiche par erreur dans un environnement non interactif.
</ResponseField>

<ResponseField name="verify" type="bool">
  Vérifie les identifiants d’authentification auprès du serveur W\&B et lève une AuthenticationError en cas d’échec. Fonctionne aussi bien avec les clés API qu’avec les jetons d’identité.
</ResponseField>

<ResponseField name="referrer" type="str | None">
  Le référent à utiliser dans la requête de connexion par URL, à des fins d’analyse.
</ResponseField>

<ResponseField name="prompt" type="bool">
  Indique s’il faut demander une clé API de manière interactive lorsqu’aucune n’est configurée. Si False, renvoie False sans modifier la session ni les paramètres.
</ResponseField>

<ResponseField name="anonymous" type="DoNotSet">
  Aucune description fournie.
</ResponseField>

<h2 id="returns">
  Renvoie
</h2>

True si la session dispose d’identifiants d’authentification après cet appel.

<h2 id="raises">
  Exceptions levées
</h2>

* `AuthenticationError` : si le serveur rejette les identifiants d’authentification lors de la vérification.
* `UsageError` : si aucun identifiant d’authentification n’est configuré, que `prompt` vaut True et qu’aucun terminal n’est disponible pour demander une clé API.
