> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-docs-sandboxes-integrations-placement.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# login()

export const GitHubLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="github-source-link">
    <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 url="https://github.com/wandb/wandb/blob/main/wandb/sdk/wandb_login.py" />

### <kbd>함수</kbd> `login`

```python theme={null}
login(
    key: 'str | None' = None,
    relogin: 'bool | None' = None,
    host: 'str | None' = None,
    force: 'bool | None' = None,
    timeout: 'int | None' = None,
    verify: 'bool' = False,
    referrer: 'str | None' = None,
    anonymous: 'DoNotSet' = <object object at 0x109b16dd0>
) → bool
```

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

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

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

WANDB\_IDENTITY\_TOKEN\_FILE 환경 변수 등을 통해 identity\_token\_file 설정이 지정되어 있으면, 이 호출은 아무 작업도 하지 않습니다.

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

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

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

**매개변수:**

* `key`: 사용할 API 키입니다.
* `relogin`: true이면 .netrc, 환경 변수 등을 읽지 않고 대화형 프롬프트에서 API 키를 가져옵니다.
* `host`: 연결할 W\&B 서버 URL입니다.
* `force`: true이면 대화형 프롬프트에서 오프라인 모드를 선택할 수 없게 합니다.
* `timeout`: 대화형 프롬프트에서 사용자 입력을 기다리는 시간(초)입니다. 비대화형 환경에서 대화형 프롬프트가 잘못 표시되는 경우를 대비한 안전장치로 사용할 수 있습니다.
* `verify`: W\&B 서버로 자격 증명을 확인하고, 실패하면 AuthenticationError를 발생시킵니다.
* `referrer`: 분석을 위해 URL 로그인 요청에 사용할 referrer입니다.

**반환값:**

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

**예외:**

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