# CALF client installation with an AI / AI와 함께 CALF 클라이언트 설치하기

Guide: https://www.vibepackr.com/poc/workbench/ · 한국어: https://www.vibepackr.com/ko/poc/workbench/

This file prepares the CALF client used by the Customer Workbench Integration example. Read it once, choose the matching OS, and execute each step once. English and Korean describe the same procedure.

고객 Workbench 연동 예제에서 사용할 CALF 클라이언트를 준비하는 안내입니다. 운영체제에 맞는 절차를 선택해 각 단계는 한 번만 실행하세요. 영문과 한국어는 같은 절차의 설명입니다.

## 1. Give your assistant this request / AI에게 전달할 문장

Use an assistant that can read local files and run commands. With a chat-only assistant, get instructions and run commands yourself.

로컬 파일과 명령을 사용할 수 있는 AI에게 전달하세요. 일반 채팅 AI라면 설명을 받고 명령은 직접 실행합니다.

```text
Read https://www.vibepackr.com/poc/workbench/install.md and help me prepare the CALF client for this PoC reference lab.
Check my actual OS/CPU, existing CALF/SDK/Python locations and permitted working directory first.
Use the reference lab's Workbench 1.9.9 (or Harness 1.8.13) and SDK 0.2.6; verify the exact archives against their official checksums.
Extract into new versioned folders. Preserve all existing CALF records, contracts, settings, runtimes and installed versions.
Within my installation authorization, check the actual native version/help and SDK import. State system prerequisites that still need attention.
Keep host hooks, MCP settings, provider calls and existing task execution outside this initial installation. Report actual commands, results and paths; distinguish installation readiness from a completed integration.
```

```text
https://www.vibepackr.com/poc/workbench/install.md 를 읽고 이 PoC 참조 실습용 CALF 클라이언트 준비를 도와줘.
실제 운영체제·CPU와 기존 CALF·SDK·Python 위치, 내가 허용한 작업 폴더부터 확인해줘.
참조 실습의 Workbench 1.9.9(또는 Harness 1.8.13)·SDK 0.2.6을 사용하고, 정확한 압축파일을 공식 체크섬과 대조해줘.
새 버전별 폴더에 풀고 기존 CALF 기록·계약·설정·runtimes·설치 버전을 보존해줘.
내 설치 권한 범위에서 실제 네이티브 버전·도움말과 SDK import를 확인하고, 아직 필요한 시스템 준비 사항을 알려줘.
이번 첫 설치에 호스트 훅·MCP 설정 변경, 생성 API 호출, 기존 작업 실행은 포함하지 마. 실제 명령·결과·경로를 기록하고 설치 준비와 연동 완료를 구분해줘.
```

## 2. Choose the intended version / 설치 목적과 버전

| Purpose / 목적 | Version and route / 버전·경로 |
|---|---|
| Current walkthrough / 현재 실습 | Workbench **1.9.9** or headless Harness **1.8.13**, SDK **0.2.6**. Published 11 November 2026. / 2026년 11월 11일 배포본을 기준으로 합니다. |
| Newer release or another setup / 이후 버전·다른 구성 | Check the [official downloads](https://github.com/VibePakcr/CALF/blob/main/DOWNLOADS.md) and the matching manual. Review compatibility before changing a pinned installation. / 공식 다운로드와 해당 매뉴얼을 확인하고, 고정된 설치 버전을 바꾸기 전에 호환성을 검토하세요. |

The current report-binding compatibility check used a synthetic analysis envelope on macOS ARM64. The original native VibePackr connection qualification used CALF 1.8.7 / Workbench 1.9.2 / SDK 0.2.1 on 6 November; it remains a historical record. Current CALF three-OS checks do not establish customer VibePackr integration on every OS.

최신 보고서 바인딩의 호환성은 macOS ARM64에서 합성 분석 응답으로 확인했습니다. 11월 6일 CALF 1.8.7·Workbench 1.9.2·SDK 0.2.1로 확인한 최초 VibePackr 네이티브 연결은 당시 기록으로 보존합니다. CALF의 세 운영체제 검증이 모든 고객 환경의 VibePackr 연동을 보증하지는 않습니다.

This installs a local CALF client. The VibePackr server has its separate [VM installation guide](https://www.vibepackr.com/install.md). No AI account, generation key or model call is needed for the checks below. A compatible AI host is prepared separately when you choose to connect one.

여기서는 로컬 CALF 클라이언트를 준비합니다. VibePackr 서버는 별도의 [VM 설치 안내](https://www.vibepackr.com/install.md)를 따릅니다. 아래 확인에는 AI 계정·생성 API 키·모델 호출이 필요하지 않으며, AI 호스트 연결은 선택 시 별도로 준비합니다.

## 3. Download matching files / 맞는 파일 받기

| Client OS / 클라이언트 운영체제 | Reference Workbench / 참조 Workbench | Requirements / 준비물 |
|---|---|---|
| macOS ARM64 | [Workbench 1.9.9 ZIP](https://github.com/VibePakcr/CALF/releases/download/v1.9.9/CALF-Workbench-1.9.9-macos-arm64.zip) | Apple Silicon, macOS 14+ |
| Windows x64 | [Workbench 1.9.9 ZIP](https://github.com/VibePakcr/CALF/releases/download/v1.9.9/CALF-Workbench-1.9.9-windows-x86_64.zip) | WebView2 |
| Linux x64 | [Workbench 1.9.9 tar.gz](https://github.com/VibePakcr/CALF/releases/download/v1.9.9/CALF-Workbench-1.9.9-linux-x86_64.tar.gz) | glibc, GTK 3, WebKitGTK 4.1; Debian 13 tested / 검증 |

Also obtain [SDK 0.2.6 ZIP](https://github.com/VibePakcr/CALF/releases/download/sdk-v0.2.6/CALF-SDK-0.2.6.zip), [Workbench SHA256SUMS](https://github.com/VibePakcr/CALF/releases/download/v1.9.9/SHA256SUMS) and [SDK-SHA256SUMS](https://github.com/VibePakcr/CALF/releases/download/sdk-v0.2.6/SDK-SHA256SUMS). Python **3.10+** is needed by this reference example. For a terminal-only client, select the matching archive and checksums from [Harness 1.8.13](https://github.com/VibePakcr/CALF/releases/tag/v1.8.13).

SDK와 두 체크섬 파일도 함께 받으세요. 참조 예제에는 Python 3.10 이상이 필요합니다. 터미널만 사용할 때는 Harness 1.8.13 릴리스에서 맞는 압축파일·체크섬을 선택합니다. 지원하지 않는 OS·CPU용 파일을 임의로 대체하지 않습니다.

## 4. Verify and extract / 확인 후 압축 풀기

Calculate SHA-256 using `shasum -a 256` on macOS, `Get-FileHash -Algorithm SHA256` in PowerShell, or `sha256sum` on Linux. Compare the exact filename and hash against the official manifest for that release. Stop on mismatch. A hash establishes byte identity, not a publisher signature.

운영체제의 SHA-256 명령으로 압축파일을 확인하고 해당 공식 릴리스 목록의 **정확한 파일명·해시**와 비교하세요. 불일치하면 실행하지 않습니다. 체크섬은 바이트 일치를 확인하며 게시자 서명을 대신하지 않습니다.

Extract the complete Workbench and SDK into separate new versioned folders. Retain the original archives and all earlier CALF locations. Do not merge the new files into an old installation or move an existing records home.

Workbench와 SDK 전체를 각각 **새 버전별 폴더**에 풉니다. 원본 압축과 이전 설치 위치를 유지하며, 기존 설치에 덮어쓰거나 기록 폴더를 이동하지 않습니다.

CALF is free to use with a closed core. macOS releases are ad-hoc signed, not notarized; Windows has no publisher signature. Follow your OS's supported trust process and your organization's policy. Preserve system security protections.

CALF는 사용이 무료이며 코어는 비공개입니다. macOS 배포판은 ad-hoc 서명이고 공증되지 않았으며 Windows는 게시자 서명이 없습니다. OS의 정상 신뢰 절차와 조직 정책을 따릅니다.

## 5. Confirm the installed files / 실제 파일 확인

Replace every example path with an observed absolute path. `CALF` selects the native `calf` or `calf.exe`, not a GUI launcher or `.app` directory. `SDK` selects the directory immediately containing `calf_sdk`. The commands print version/help and import the selected SDK; they do not submit work.

예시 경로는 모두 실제 절대 경로로 바꾸세요. `CALF`는 네이티브 실행 파일이며 GUI 실행기나 `.app` 폴더가 아닙니다. `SDK`는 바로 아래에 `calf_sdk`가 있는 폴더입니다. 아래 명령은 버전·도움말·SDK 위치를 확인하며 작업을 제출하지 않습니다.

macOS:

```sh
CALF="/absolute/CALF-Workbench-1.9.9-macos-arm64/CALF Workbench.app/Contents/MacOS/calf"
SDK="/absolute/CALF-SDK-0.2.6"
"$CALF" --version
"$CALF" --help
python3 --version
python3 -B -c 'import sys; sys.path.insert(0, sys.argv[1]); import calf_sdk; print(calf_sdk.__file__)' "$SDK"
```

Windows PowerShell:

```powershell
$Calf = 'C:\absolute\CALF-Workbench-1.9.9-windows-x86_64\calf.exe'
$Sdk = 'C:\absolute\CALF-SDK-0.2.6'
& $Calf --version
& $Calf --help
python --version
python -B -c "import sys; sys.path.insert(0, sys.argv[1]); import calf_sdk; print(calf_sdk.__file__)" $Sdk
```

Linux:

```sh
CALF="/absolute/CALF-Workbench-1.9.9-linux-x86_64/calf"
SDK="/absolute/CALF-SDK-0.2.6"
"$CALF" --version
"$CALF" --help
python3 --version
python3 -B -c 'import sys; sys.path.insert(0, sys.argv[1]); import calf_sdk; print(calf_sdk.__file__)' "$SDK"
```

Retain the actual version, help result, SDK import path, checksum comparison and any missing runtime prerequisites. If the executable cannot start or the SDK import fails, report that state and the actual error. Help alone does not verify VibePackr integration.

실제 버전·도움말 결과·SDK import 위치·체크섬 비교와 누락된 실행 조건을 기록하세요. 실행 또는 import 실패는 실제 오류와 함께 남깁니다. 도움말이 열렸다는 사실만으로 VibePackr 연동 완료를 표시하지 않습니다.

## 6. Continue with the reference walkthrough / 참조 실습 이어가기

Follow [preparation](https://www.vibepackr.com/poc/workbench/#prepare) / [준비](https://www.vibepackr.com/ko/poc/workbench/#prepare), then [download, verify and open](https://www.vibepackr.com/poc/workbench/#install) / [다운로드·실행](https://www.vibepackr.com/ko/poc/workbench/#install). Choose a new private exercise folder and new CALF records home before opening the exercise window. Keep the same explicit records location in Workbench and SDK.

개인 실습 폴더와 **새 CALF 기록 위치**를 정한 뒤 매뉴얼의 동일한 `CALF_WORK_HOME`으로 창과 SDK를 실행하세요. 실제 VibePackr 네이티브 패키지·등록 입력·검증된 연결 정보는 [준비 항목](https://www.vibepackr.com/ko/poc/workbench/#prepare)에 따라 담당자가 별도로 제공합니다.

This page publishes instructions; it does not install software on the visitor's computer. Preserve existing `history.html`, contracts, settings, records and runtime folders. Record your selected paths and actual check results in your private installation notes. Never paste credentials or private connection files into public issue reports.

이 페이지는 설치 지침이며 방문자 컴퓨터에서 자동 실행되지 않습니다. 기존 `history.html`·계약·설정·기록·runtimes 폴더를 유지하고 선택한 경로와 실제 확인 결과를 개인 설치 기록에 남기세요. 비밀값이나 개인 연결 파일을 공개 이슈에 붙여 넣지 않습니다.