Galpi

로컬에서 써 보기

VM 없이 이 컴퓨터에서 갈피를 띄워 화면과 흐름을 확인해요. 로컬 VM은 폴더에서 진짜 bash와 git을 돌려요.

로컬 VM(VM_PROVIDER=local)은 VM 대신 DATA_DIR/local-vms/ 아래 폴더를 써요. 그 안에서 실제 bash와 git이 돌고, 공개 저장소(HTTPS)는 실제로 clone돼요. 에이전트는 기본으로 짜인 답을 하고, 원하면 진짜 opencode와 모델로 바꿀 수 있어요(아래 4단계). 운영에서는 쓰지 않아요.

필요한 것

  • Node.js 24 이상과 pnpm(저장소의 packageManager가 정한 판, corepack enable이면 저절로 맞춰요)
  • git, bash, Python 3(미리보기 예시에서 씀)

띄우기

  1. 의존성을 설치해요.

    bash
    git clone <갈피 저장소> galpi && cd galpi
    pnpm install
    
  2. 서버를 띄워요. LOCAL_LOGIN_CODE를 정해 두면 모든 로그인 코드가 그 숫자가 되고 처음 설정 화면도 건너뛰어요(VM_PROVIDER=local에서만 받아요).

    bash
    export SECRETS_KEY=$(openssl rand -base64 32)
    export VM_PROVIDER=local ADMIN_EMAILS=me@example.com LOCAL_LOGIN_CODE=123456
    pnpm dev:server   # :8080
    
  3. 다른 터미널에서 웹을 띄워요. Vite가 /api와 /internal을 8080으로 넘겨요.

    bash
    pnpm dev:web      # :5173
    
  4. (선택) 진짜 모델로 답을 받으려면 갈피가 고정한 판의 opencode를 설치하고 경로를 알려 줘요. 모델은 서버의 LLM_* 설정을 갈피의 중계로 써요. 서버를 다시 띄워요.

    bash
    npm i -g opencode-ai@$(sed -n "s/.*'\(.*\)'.*/\1/p" apps/server/src/opencode/resolved-version.ts)
    export LOCAL_OPENCODE_BIN=$(which opencode)
    export LLM_API_FORMAT=openai LLM_BASE_URL=https://llm.example.com/v1 LLM_API_KEY=sk-… LLM_MODEL=<모델>
    
  5. http://localhost:5173을 열고 이메일을 넣어요. 코드는 123456이에요(LOCAL_LOGIN_CODE가 없으면 서버 로그의 [mail] 블록에 찍혀요). 처음이면 부를 이름을 물어요.

로그인. 이메일을 넣으면 6자리 코드를 보내요.로그인. 이메일을 넣으면 6자리 코드를 보내요.
로그인. 이메일을 넣으면 6자리 코드를 보내요.

첫 채팅

로그인하면 새 채팅 화면이에요. 처음에는 프로젝트 없음이라 저장소 없이 파일과 대화로 일해요. 아무 질문이나 보내 보세요.

새 채팅. 아래 입력 칸에서 프로젝트와 모드를 골라요.새 채팅. 아래 입력 칸에서 프로젝트와 모드를 골라요.
새 채팅. 아래 입력 칸에서 프로젝트와 모드를 골라요.

저장소로 일해 보기

  1. 계정 메뉴의 프로젝트 관리에서 새 프로젝트를 만들어요(또는 http://localhost:5173/projects/new).
  2. 저장소 단계에서 공개 저장소 주소(예: https://github.com/octocat/Spoon-Knife)를 넣고 공개 저장소를 골라 저장해요. 갈피가 바로 접속해 보고 기본 브랜치와 최신 커밋을 보여 줘요.
  3. 프로젝트 관리 → 미리보기에서 시작 명령을 적어요. 이 예시는 정적 파일이라 python3 -m http.server 8080 --bind 0.0.0.0이면 돼요.
  4. 새 채팅에서 그 프로젝트를 고르고 "index.html의 제목을 바꿔 줘"처럼 물어요. 답이 끝나면 위의 미리보기 켜기로 띄워요. 로컬에서는 미리보기가 이 컴퓨터의 진짜 프로세스로 뜨고 주소는 http://localhost:<포트>/예요.

갈피를 갈피로 고치기

갈피 저장소를 갈피 프로젝트로 쓰면 채팅에서 갈피 자체를 미리보기로 띄울 수 있어요(.galpi/preview.yml, .galpi/preview.sh). 서버는 로컬 VM으로, 화면은 Vite로 떠서 고친 화면이 저장하자마자 보여요. 미리보기 막대의 이메일과 로그인 코드로 관리자로 들어가요. 테스트 데이터는 체크아웃 밖(~/galpi-preview)에 둬요.

테스트

bash
pnpm -r typecheck
pnpm --filter @galpi/server test            # github.com에 접속하는 테스트 포함
GALPI_OFFLINE=1 pnpm --filter @galpi/server test
pnpm node-kit:install && npm --prefix node-kit run typecheck && npm --prefix node-kit test
pnpm typecheck && pnpm test                 # 위를 한 번에
다음

서버에 설치하려면 설치와 처음 설정을 봐요.

Esc