[오류Error] Failed to start project studioError invoking remote method 'up': Error: Docker not installed or not running: ExecaError: Command failed with exit code 1: which docker

LangGraph를 공부하던 중 Agentic Application을 만들기 위한 IDE인 LangGraph Studio라는 서비스를 알게 되었습니다. 이 도구가 AI 에이전트 개발을 시각적으로 도와준다고 하여 설치해보기로 했습니다.

 

설치 과정

LangGraph Studio는 현재 맥북에서만 지원되는 것 같습니다. 공식 사이트에서 dmg 파일을 다운로드하여 설치했습니다.

 

첫 번째 오류: Docker 관련 문제

설치 후 실행했더니 다음과 같은 오류가 발생했습니다.

Failed to start project studio
Error invoking remote method 'up': Error: Docker not installed or not running: ExecaError: Command failed with exit code 1: which docker

 

(도커가 필요한 줄 몰랐다.. 그래서 바로 Docker 를 설치해주었다.)

해결 방법

Docker Desktop: The #1 Containerization Tool for Developers | Docker

 

1. Docker 설치 확인하기 Docker가 설치되어 있지 않다면, Docker 공식 사이트에서 운영체제에 맞는 Docker Desktop을 다운로드하여 설치한다.
2. Docker 실행 확인하기 Docker Desktop을 실행하고, 상태 표시기(시스템 트레이/메뉴바)에서 Docker가 실행 중인지 확인한다.
3. Docker 버전 확인하기 LangGraph Studio는 Docker Compose 버전 2.22.0 이상을 요구합니다. 터미널에서 docker-compose --version 명령으로 버전을 확인하고, 필요시 업데이트한다.

 

두 번째 오류: .env 파일 문제

Docker를 설치하고 실행한 후 LangGraph Studio를 다시 시작했더니 오류 메시지가 바뀌었다.

Failed to start project studio
Error invoking remote method 'up': Error: Could not read env file: /Users/path/to/project/studio/.env

LangGraph Studio가 API 키와 같은 환경 변수를 담고 있는 .env 파일을 찾을 수 없어서 발생한 문제였습니다.

 

해결 방법

다행히 제가 사용하려던 프로젝트 폴더에는 .env.example 파일이 이미 존재했습니다. 이 파일은 필요한 환경 변수의 템플릿 역할을 합니다.

1. .env.example 파일을 .env 파일로 복사해주었습니다.

cp /path/to/project/studio/.env.example /path/to/project/studio/.env

 

2. 텍스트 에디터로 .env 파일을 열고 OpenAI API 키를 입력했습니다.

OPENAI_API_KEY=sk-my_api_key_here

 

 

LangGraph Studio를 재시작했더니 드디어 정상적으로 로드 성공!