설치와 첫 로그인

Docker가 있는 PC 한 대에 명령 한 줄로 Process GPT Lite를 설치하고, LLM 키를 넣고, 이메일로 받은 코드로 처음 로그인합니다. 로그인 뒤에 이어지는 첫 화면 안내(생년월일 → 인사 → 메일 연결)까지 마치면 2장부터 실습할 준비가 끝납니다.

무엇이 설치되나#

Process GPT Lite는 화면(웹 앱) 과 그 뒤에서 일하는 Process GPT 백엔드로 이루어져 있습니다. 설치 스크립트는 이 모두를 Docker 컨테이너로 내려받아 빌드하고, 데이터베이스를 준비하고, 첫 관리자 계정까지 만들어 줍니다.

모든 것이 내 PC 안에서 돕니다. 바깥으로 나가는 것은 LLM 호출(설정한 API 주소)과, 연결했을 때의 메일·외부 서비스뿐입니다.

준비물#

macOS, Linux, Windows(WSL2)에서 설치할 수 있습니다. Windows는 WSL2 안에 Docker Engine을 설치해 쓰는 것을 권장합니다.

설치하기#

터미널에서 한 줄을 실행합니다. 저장소를 ~/process-gpt-lite에 받고 설치 스크립트를 실행합니다.

curl -fsSL https://raw.githubusercontent.com/uengine-oss/process-gpt-lite/main/install/get.sh | bash

저장소를 직접 받아도 같습니다.

git clone https://github.com/uengine-oss/process-gpt-lite.git
cd process-gpt-lite/install
./install.sh

스크립트가 몇 가지를 묻습니다. 괄호 안이 기본값이고, 그냥 Enter를 누르면 기본값을 씁니다.

처음에는 이미지를 빌드하느라 20~40분 걸립니다(이음오피스 편집기가 가장 오래 걸립니다). 끝나면 다음과 같은 요약이 나옵니다.

  Process GPT Lite 가 준비됐습니다

    주소        http://localhost:18080
    관리자      admin@pgpt-lite.local
    로그인 코드  이메일을 입력하면 코드가 메일함으로 갑니다 → http://localhost:18025

프로필 — 무엇까지 띄울까#

설정 파일 .env#

설치 폴더(install/)의 .env가 모든 설정을 담습니다. 처음 실행할 때 만들어지고, 권한은 본인만 읽을 수 있는 0600입니다. 데이터베이스 비밀번호, 로그인 토큰 서명 키, 보관함 마스터 키 같은 비밀 값은 스크립트가 무작위로 만들어 채우며 화면이나 로그에 찍지 않습니다. 업그레이드해도 그대로 유지됩니다.

자주 손대는 값은 다음과 같습니다.

.env를 고친 뒤에는 ./install.sh를 다시 실행하면 바뀐 값으로 컨테이너가 다시 뜹니다. 데이터는 그대로입니다.

포트와 접속 주소#

기본으로는 이 PC에서만 열립니다(127.0.0.1). 18080을 다른 프로그램이 쓰고 있으면 ./install.sh --port 28080처럼 바꿉니다. 팀원이 다른 PC에서 접속하게 하려면 .env에서 PUBLIC_URL=http://<이 PC의 IP>:18080, LITE_BIND=0.0.0.0으로 바꾸고 SMTP를 설정한 뒤 ./install.sh를 다시 실행합니다. 번들 메일함은 이 PC에서만 열리기 때문입니다. 인터넷에 열 때는 앞에 HTTPS 리버스 프록시를 둡니다.

첫 로그인#

브라우저로 http://localhost:18080을 엽니다. 왼쪽 하늘 그림 위로 “노스윈드 견적 요청 메일에 작년 조건으로 회신 초안 써줘” 같은 예시 문장이 한 글자씩 써집니다. 이 앱에 무엇을 시킬 수 있는지 보여 주는 예입니다.

1. 이메일 주소를 적고 「계속」을 누릅니다. 설치할 때 적은 관리자 이메일로 먼저 로그인해 보세요.
2. 번들 메일함 http://localhost:18025를 열면 6자리 코드가 담긴 메일이 와 있습니다. SMTP를 설정했다면 실제 메일함으로 갑니다.
3. 코드 여섯 칸에 입력하면 바로 로그인됩니다. 붙여 넣기도 됩니다.

.env에 GOOGLE_CLIENT_ID·GOOGLE_CLIENT_SECRET을 넣었다면 「Google로 계속하기」로도 로그인할 수 있습니다. 넣지 않았으면 이 버튼은 “이메일로 계속해 주세요”라고 안내합니다.

처음 한 번 — 첫 화면 안내#

처음 로그인하면 세 화면이 차례로 나옵니다. 한 번만 나오고, 다음부터는 바로 채팅 화면이 열립니다.

① 생년월일. 연령에 맞는 서비스를 위해 묻는 것이고 다른 사람에게 보이지 않습니다. 연도·월·일을 고르고 「계속」을 누릅니다.

② 인사. “process gpt, 저는 당신만의 업무 운영체제처럼 생각하시면 돼요.”라는 문장이 써진 뒤 저절로 채팅 화면으로 넘어갑니다.

③ 비서의 자기소개와 메일 연결. 채팅에 비서가 세 문장으로 자기소개를 하고, 메일을 연결하자고 제안합니다. Google 로그인을 설정한 서버에서는 버튼이 「Google에 로그인」, 아니면 「메일 연결하기」로 보입니다.

버튼을 누르면 연결 방법을 고르는 창이 뜹니다. 이 튜토리얼에서는 「데모 메일함」을 고릅니다. 가상의 거래처 메일 다섯 통이 들어 있는 연습용 메일함이라, 실제 메일을 연결하지 않고도 다음 장들을 그대로 따라 할 수 있습니다. Gmail과 IMAP 연결은 5장에서 자세히 다룹니다.

연결하고 1분쯤 지나면 비서가 메일을 읽고 채팅에 오후 브리프(아침이면 모닝 브리프)를 남기고, 홈에 할 일 카드 네 장을 올립니다.

멈추기·업그레이드·지우기#

문제가 생기면#

다음 장으로#

설치와 첫 로그인이 끝났습니다. 다음 장에서는 방금 연 화면 — 홈 카드, 채팅, 위쪽 막대, 설정 — 을 한 바퀴 둘러봅니다(2장).