CLI 설치 및 설정

Roboflow CLI를 설치하고, 인증하고, 기본 워크스페이스를 설정하고, 셸 자동 완성을 활성화합니다.

필요합니다 Python >=3.10 Roboflow Python 패키지를 사용하려면.

Python을 설치한 후, 다음 명령을 실행하여 설치하세요:

pip install roboflow

설치한 후, CLI가 작동하는지 테스트하세요:

roboflow --help

인증

인증하는 방법은 세 가지가 있습니다:

옵션 1: 환경 변수(스크립트와 에이전트에 권장)

export ROBOFLOW_API_KEY=rf_xxxxx

CI/CD, 자동화, AI 코딩 에이전트에 권장되는 방법입니다. 대화형 프롬프트가 필요하지 않습니다.

옵션 2: API 키 플래그

roboflow --api-key rf_xxxxx project list

키를 모든 명령에 직접 전달합니다. 한 번만 실행하는 명령에 유용합니다.

옵션 3: 대화형 로그인

roboflow login

브라우저에서 링크를 열고 토큰을 받은 뒤 터미널에 붙여넣으세요. 자격 증명은 다음 위치에 저장됩니다 ~/.config/roboflow/config.json 그래서 한 번만 하면 됩니다.

다음과 같이 비대화형으로도 로그인할 수 있습니다:

roboflow auth login --api-key rf_xxxxx

인증 확인

roboflow auth status

현재 작업 공간과 마스킹된 API 키를 표시합니다.

기본 작업 공간 설정

여러 작업 공간에 접근할 수 있는 경우, 기본으로 사용할 작업 공간을 설정하세요:

roboflow auth set-workspace my-workspace-id

셸 자동 완성(선택 사항)

명령, 옵션, 인수에 대한 탭 자동 완성을 활성화하세요:

# Zsh
eval "$(roboflow completion zsh)"

# Bash(bash >= 4.4 필요)
eval "$(roboflow completion bash)"

# Fish
roboflow completion fish | source

영구적으로 사용하려면 eval 줄을 셸 프로필에 추가하세요(~/.zshrc, ~/.bashrc, 등).