> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-docs-2516.mintlify.site/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 ? "소스 보기" : <>
    <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 소스 코드
      </>}
  </a>;

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

## <Badge color="blue" size="lg" shape="rounded">함수</Badge> wandb.login()

W\&B에 로그인합니다.

일반적으로는 이것을 사용할 필요가 없습니다. 인증이 필요한 대부분의 W\&B 메서드는 자동으로 로그인할 수 있기 때문입니다. 이는 `wandb login` CLI에 해당하는 프로그래밍 방식입니다.

이 호출은 세션의 전역 자격 증명을 업데이트하며(이 호출 이후 현재 Python 프로세스에서의 모든 wandb 사용에 영향), 경우에 따라 .netrc 파일도 업데이트합니다.

WANDB\_IDENTITY\_TOKEN\_FILE 환경 변수 등을 통해 ID 토큰 파일이 설정되어 있으면, 해당 파일을 세션(연합 ID)에 사용하며 API 키를 읽거나 저장하지 않습니다.

그렇지 않은 경우, 명시적인 API 키가 제공되면 해당 키를 사용하고 시스템 .netrc 파일에 기록합니다. 키가 제공되지 않았지만 세션이 이미 인증된 상태라면, 세션 키를 확인에 사용하고(`verify`가 True인 경우) .netrc 파일은 업데이트하지 않습니다.

위 조건이 모두 해당하지 않으면, 다음 항목 중 가장 먼저 확인되는 곳에서 API 키를 가져옵니다:

* WANDB\_API\_KEY 환경 변수
* 시스템 또는 Workspace settings 파일의 api\_key 설정
* .netrc 파일(\~/.netrc, \~/\_netrc 또는 NETRC 환경 변수로 지정된 경로)
* 대화형 프롬프트(사용 가능한 경우)

```python theme={null}
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,
anonymous: 'DoNotSet' = DoNotSet
```

<div id="args">
  ## 인수
</div>

<ResponseField name="key" type="str | None">
  사용할 API 키입니다.
</ResponseField>

<ResponseField name="relogin" type="bool | None">
  true이면 .netrc, 환경 변수 등을 읽지 않고 대화형 프롬프트를 통해 API 키를 가져옵니다.
</ResponseField>

<ResponseField name="host" type="str | None">
  연결할 W\&B 서버 URL입니다.
</ResponseField>

<ResponseField name="force" type="bool | None">
  true이면 대화형 프롬프트에서 offline mode를 선택할 수 없습니다.
</ResponseField>

<ResponseField name="timeout" type="int | None">
  대화형 프롬프트에서 사용자 입력을 기다리는 시간(초)입니다. 비대화형 환경에서 대화형 프롬프트가 잘못 표시되는 경우 안전장치로 사용할 수 있습니다.
</ResponseField>

<ResponseField name="verify" type="bool">
  W\&B 서버에서 자격 증명을 확인하고, 실패하면 AuthenticationError를 발생시킵니다. API 키와 ID 토큰 모두에 적용됩니다.
</ResponseField>

<ResponseField name="referrer" type="str | None">
  분석을 위해 URL 로그인 요청에 사용할 리퍼러입니다.
</ResponseField>

<ResponseField name="anonymous" type="DoNotSet">
  설명이 제공되지 않았습니다.
</ResponseField>

<div id="returns">
  ## 반환값
</div>

`bool`: `key`가 설정된 경우입니다.

<div id="raises">
  ## 예외
</div>

* `AuthenticationError`: 자격 증명이 서버 검증에 실패한 경우.
* `UsageError`: `api_key`를 설정할 수 없고 tty도 없는 경우.