CLI

Roboflow CLI 명령, 전역 플래그, JSON 출력, 리소스 축약형, 편의 별칭에 대한 참고.

Roboflow Python 패키지에는 CLI(pip install roboflow)가 포함되어 있으며, 이를 사용해 명령줄에서 Roboflow 플랫폼과 작업할 수 있습니다. 이 CLI는 일관된 roboflow <noun> <verb> 형식을 따르며, AI 코딩 에이전트 및 자동화 도구에서 사용할 수 있도록 구조화된 JSON 출력을 지원합니다.

명령

명령	설명
인증	로그인, 로그아웃, 상태 확인, 기본 워크스페이스 설정
workspace	워크스페이스 목록 조회 및 검사
프로젝트	프로젝트 목록 조회, 조회 및 생성
버전	데이터셋 버전 목록 조회, 조회, 다운로드 및 내보내기
image	이미지 업로드, 조회, 검색, 태그 지정, 삭제 및 주석 처리
모델	학습된 모델 목록 조회, 조회 및 업로드
학습	모델 학습 시작
infer	이미지에서 추론 실행
검색	워크스페이스 이미지를 검색하고 결과를 내보내기
배포	전용 배포 관리
워크플로로	워크플로 관리
폴더	워크스페이스 폴더 관리
주석	주석 배치 및 작업
유니버스	Roboflow Universe 검색
비디오	비디오 추론
배치	배치 처리 작업 (출시 예정)
자동 완성	셸 자동 완성 스크립트 생성(bash, zsh, fish)

실행 roboflow <command> --help 를 실행하세요.

전역 플래그

이 플래그들은 모든 명령에서 작동하며 하위 명령 앞이나 뒤에 올 수 있습니다:

플래그	단축	설명
--json	-j	결과를 구조화된 JSON으로 출력(에이전트 및 파이핑용)
--api-key	-k	API 키 재정의
--workspace	-w	워크스페이스 재정의
--quiet	-q	진행 표시줄과 상태 메시지를 숨김
--version		패키지 버전 표시

에이전트를 위한 JSON 출력

모든 명령은 --json 파이프로 넘기고 프로그램적으로 파싱해도 안전한 구조화된 출력을 위해 지원합니다:

roboflow --json project list | jq '.[0].id'

JSON 모드의 오류는 빈 stdout과 함께 stderr로 출력되므로 파이핑해도 안전합니다:

roboflow --json project get nonexistent 2>error.json
# stdout는 비어 있고, stderr에는 다음이 포함됩니다: {"error": {"message": "...", "hint": "..."}}

종료 코드는 일관됩니다: 0 = 성공, 1 = 오류, 2 = 인증 오류, 3 = 찾을 수 없음.

리소스 축약 표기

리소스는 간단한 식별자로 지정할 수 있습니다:

축약 표기	의미
my-project	기본 워크스페이스를 사용합니다
my-ws/my-project	명시적 워크스페이스
my-project/3	기본 워크스페이스, 버전 3
my-ws/my-project/3	명시적 워크스페이스, 버전 3

버전 번호는 항상 숫자입니다. 이것이 x/y 가 구분되는 방식입니다 워크스페이스/프로젝트 및 프로젝트/버전.

편의 별칭

일반적인 작업에는 짧은 최상위 별칭이 있습니다:

별칭	동일 명령
roboflow login	roboflow auth login
roboflow whoami	roboflow auth status
roboflow upload	roboflow image upload
roboflow download	roboflow version download