Griptape Nodes 명령줄 인터페이스 (CLI)
명령줄 인터페이스(CLI)가 처음이시라면, CLI는 UI에서 버튼을 클릭하는 대신 명령어를 입력하여 소프트웨어와 상호작용하는 텍스트 기반 방식입니다. Griptape Nodes는 griptape-nodes(또는 gtn) 명령어를 통해 터미널에서 Griptape Nodes와 상호작용할 수 있는 CLI를 제공합니다.
griptape-nodes(또는 줄임말 gtn)는 컴퓨터에 설치된 Griptape Nodes Engine을 실행하고 관리하도록 특별히 설계된 명령줄 도구입니다. 이 도구는 워크스페이스 초기화, 구성 설정 관리, 웹 기반 Griptape Nodes 에디터를 구동하는 엔진 시작 등의 작업을 처리합니다. 실제 워크플로우의 생성 및 편집은 엔진을 실행할 때 열리는 웹 인터페이스에서 수행됩니다.
기본 사용법
griptape-nodes [options] [COMMAND]
명령어를 지정하지 않으면 기본적으로 engine 명령어가 실행됩니다.
명령어 목록
engine (기본 명령어)
Griptape Nodes 엔진을 실행합니다.
griptape-nodes engine
Griptape Nodes 엔진이 시작되고 https://nodes.griptape.ai 에서 웹 인터페이스가 열립니다.
init
Griptape Nodes를 위한 새 워크스페이스를 초기화합니다: API 키, 워크스페이스 디렉토리, 스토리지 백엔드 및 (선택 사항) 추가 라이브러리를 설정합니다. 다시 실행하면 동일한 프롬프트가 다시 표시되어 나중에 이러한 설정을 변경할 수 있습니다.
griptape-nodes init [options]
옵션:
--api-key: 프롬프트 없이 Griptape API 키를 직접 지정--workspace-directory: 프롬프트 없이 워크스페이스 디렉토리를 직접 지정--storage-backend: 프롬프트 없이 스토리지 백엔드(local또는gtc) 설정--bucket-name:--storage-backend gtc설정 시 사용할 버킷 이름(기존 또는 신규)--register-diffusers-library/--no-register-diffusers-library: Griptape Nodes Diffusers Library 설치 (또는 건너뛰기)--register-griptape-cloud-library/--no-register-griptape-cloud-library: Griptape Cloud Library 설치 (또는 건너뛰기)--no-interactive: 프롬프트 없이 제공된 플래그 및 기본값만 사용하여 init 실행--hf-token: 접근 제한 모델을 다운로드하는 데 사용되는 Hugging Face 토큰 설정--config key=value: 임의의 설정 값 지정 (예:--config log_level=DEBUG --config workspace_directory=/tmp와 같이 반복 지정 가능)--secret key=value: 임의의 비밀 값 지정 (예:--secret MY_API_KEY=abc123과 같이 반복 지정 가능)
config
Griptape Nodes 설정을 관리합니다.
griptape-nodes config SUBCOMMAND
하위 명령어:
show [config_path]: 현재 설정을 표시합니다. 인수 없이 실행하면 병합된 전체 설정을 JSON으로 출력하고, 점으로 구분된 경로(예:workspace_directory)를 지정하면 해당 값만 출력합니다.list: 설정에 기여하는 모든 설정 파일을 우선순위 순서대로 나열합니다.reset: 설정을 기본값으로 초기화합니다.
이 방법으로 읽거나 설정할 수 있는 전체 설정 목록은 설정 레퍼런스(Configuration Reference)를 참조하세요.
self
CLI 설치 자체를 관리합니다.
griptape-nodes self SUBCOMMAND
하위 명령어:
uninstall: CLI를 제거하며 설정 및 데이터 디렉토리와 설치된 실행 파일을 삭제합니다.version: CLI의 현재 버전을 표시합니다.info: 디버깅을 위한 시스템 정보 보고서를 출력합니다: 엔진 버전 및 설치 소스, 플랫폼 및 Python 세부 정보, 설정 경로, 각 계층의 파일 및 구문 분석 오류가 포함된 설정 레이어 스택, 현재 적용 중인 설정, 설정된 API 키 목록, 등록된 모든 라이브러리와 버전, 프로젝트 템플릿. 버그 리포트에 그대로 첨부해도 안전합니다. API 키와 기타 자격 증명은 제거되고, 홈 디렉토리 경로는~로, 사용자 이름은<user>로 바뀝니다. 보고서 끝에는 제거된 항목의 개수가 출력되므로 비어 보이는 설정이 실제로 비어 있는지 숨겨진 것인지 구분할 수 있습니다.env및runtime레이어는 자체 파일이 없습니다.env는 설정된GTN_CONFIG_*변수의 이름을 나열하며(값은 생략), 해석된 결과는 아래의 병합된 설정에 이미 표시됩니다.runtime은 활성 프로젝트에 고정된 워크스페이스 디렉토리를 표시합니다.--show-identity: 홈 디렉토리 실제 경로와 사용자 이름을~및<user>대신 그대로 표시합니다. 자격 증명은 여전히 제거됩니다.- 같은 정보와 로그를 하나의 공유 가능한 파일로 수집하려면
diagnostics collect를 사용하세요.
libraries
로컬 라이브러리를 관리합니다. 라이브러리 설치 및 관리에 대한 전체 가이드는 라이브러리를 참조하세요.
griptape-nodes libraries SUBCOMMAND
하위 명령어:
sync: 등록된 모든 라이브러리를 최신 버전으로 업데이트합니다.--overwrite: 라이브러리를 업데이트하기 전에 커밋되지 않은 로컬 변경 사항을 폐기
download <git_url>: Git에서 라이브러리를 복제하고 등록합니다.--branch: 체크아웃할 브랜치, 태그 또는 커밋--target-dir: 복제할 디렉토리 이름--download-dir: 라이브러리가 복제되는 상위 디렉토리--overwrite: 디렉토리가 이미 존재하는 경우 덮어쓰기
models
Hugging Face Hub에서 다운로드한 AI 모델을 관리합니다. 워크플로우를 실행할 때 로컬 디퓨전이나 LLM 노드가 가져오는 모델과 동일합니다.
griptape-nodes models SUBCOMMAND
하위 명령어:
download <model_id>: Hugging Face Hub에서 모델을 다운로드합니다(예:microsoft/DialoGPT-medium).--local-dir: 모델을 다운로드할 로컬 디렉토리--revision: 다운로드할 Git 리비전(기본값main)
list: 현재 로컬 캐시에 있는 모든 모델 파일과 디스크 용량을 나열합니다.delete <model_id>: 로컬 캐시에서 모델 파일을 삭제합니다.search [query]: Hugging Face Hub에서 모델을 검색합니다.--task: 작업 유형별로 결과 필터링(예:text-generation)--limit: 반환할 최대 결과 수(기본값 20, 최대 100)--sort: 결과 정렬 기준 필드(기본값downloads)--direction: 정렬 방향(기본값desc)
downloads status [model_id]: 한 모델의 다운로드 진행률/상태를 표시하거나 인수가 없으면 추적 중인 모든 모델의 상태를 표시합니다.downloads list: 추적 중인 모든 모델 다운로드와 상태를 나열합니다.downloads delete <model_id>: 모델의 다운로드 상태 추적 기록을 삭제합니다(모델 파일 자체는 삭제되지 않으며 파일 삭제는models delete사용).
doctor
Griptape Nodes 설치 상태를 점검하고 발견한 내용을 표로 출력합니다. 조치가 필요한 항목에는 해결 방법도 함께 표시됩니다.
griptape-nodes doctor
각 검사 결과는 PASS, WARN(동작은 하지만 나중에 문제가 될 수 있음), FAIL(현재 문제가 있음) 중 하나로 표시됩니다. 점검 항목은 다음과 같습니다:
- Workspace: 워크스페이스 디렉토리가 존재하고 쓰기가 가능한지 확인합니다.
- Disk Space: 워크플로우를 저장하고 라이브러리를 설치할 수 있는 여유 공간이 워크스페이스 드라이브에 있는지 확인합니다.
- Libraries: 등록된 모든 라이브러리가 로드되었고 누락된 노드와 함께 로드된 라이브러리가 없는지 확인합니다.
- Secrets: 라이브러리가 요청한 모든 API 키에 값이 있는지 확인합니다.
- Log Capture: 엔진 로그가 기록되고 있어 나중에 수집할 수 있는지 확인합니다.
- Cloud Connection: 이 머신이 에디터와 엔진 통신에 필요한 Griptape Cloud에 연결할 수 있는지 확인합니다.
검사가 실패하면 0이 아닌 상태 코드로 종료되므로 스크립트에서 안전하게 사용할 수 있습니다. 경고만 있는 경우에는 0으로 종료됩니다.
같은 결과는 진단 번들 안의 doctor.json에도 저장되므로 버그 리포트를 읽는 사람이 보고 있는 것과 같은 결과를 확인할 수 있습니다.
diagnostics
이 설치를 문제 해결하는 데 필요한 모든 정보를 하나의 zip 파일로 수집하여 버그 리포트에 첨부할 수 있게 합니다.
griptape-nodes diagnostics SUBCOMMAND
하위 명령어:
collect: 진단 번들을 작성합니다. 번들에는 로그, 현재 적용 중인 설정, 모든 라이브러리와 프로젝트 및 로드 결과,doctor의 상태 점검 결과가 포함됩니다.--output,-o: 번들을 저장할 위치입니다. 디렉토리를 지정하면 자동으로 생성된 파일 이름이 사용됩니다. 기본값은 현재 디렉토리입니다.--skip-logs: 엔진의 로그 파일을 번들에서 제외합니다.--skip-libraries: 라이브러리를 먼저 로드하지 않습니다. 더 빠르지만 번들에서 어떤 라이브러리가 로드에 실패했는지 알 수 없습니다.--show-identity: 홈 디렉토리 실제 경로와 사용자 이름을~및<user>대신 그대로 표시합니다.
번들은 어디에도 업로드되지 않습니다. 파일은 사용자의 머신에 저장되며, 공유 여부는 사용자가 결정합니다.
번들은 엔진이 작성하며, 엔진은 자신의 API 키를 알고 있으므로 수집하는 모든 파일에서 API 키를 찾아 제거합니다. 자격 증명처럼 보이는 다른 값도 함께 제거됩니다. 번들 안의 manifest.json에는 제거된 항목의 개수가 기록되며, README.md에는 각 파일에 대한 설명이 쉬운 말로 적혀 있습니다.
에디터 및 데스크톱 앱에서 같은 작업을 하려면 엔진 로그 내보내기를 참조하세요.
구성 경로 (Configuration)
Griptape Nodes는 설정을 다음 위치에 저장합니다:
- 설정 디렉토리:
~/.config/griptape_nodes(macOS/Linux) 또는%USERPROFILE%\.config\griptape_nodes(Windows) - 데이터 디렉토리:
~/.local/share/griptape_nodes(macOS/Linux) 또는%USERPROFILE%\.local\share\griptape_nodes(Windows) - 설정 파일: 설정 디렉토리 내의
griptape_nodes_config.json - 환경 파일: 설정 디렉토리 내의
.env
GTN_ENGINE_CONFIG_DIR 또는 GTN_ENGINE_DATA_DIR을 절대 경로로 설정하면 다른 설정 또는 데이터 디렉토리를 사용할 수 있습니다. 자세한 내용은 구성을 참조하세요.
Griptape Nodes Desktop은 수동 설치된 엔진과 충돌하지 않도록 이 두 디렉토리를 자체 애플리케이션 데이터 폴더 내에 보관합니다. 해당 경로는 Griptape Nodes 제거를 참조하세요.
기본 워크플로우
일반적인 사용 절차:
griptape-nodes init을 실행하여 워크스페이스 및 API 키를 설정합니다.griptape-nodes를 실행하여 엔진을 시작합니다.- 웹 인터페이스를 사용하여 워크플로우를 생성하고 관리합니다.