Virgo 설치

이 가이드는 위에 고정된 원본에서 발행됩니다. 영어 정본을 한국어로 완역했으며, 명령 구문과 출시 상태 경계, 기능 한계, 원본 hash는 그대로 보존합니다.

그림은 사이트를 빌드할 때 정적 이미지로 그려집니다. 같은 흐름을 각 그림 아래에 글로도 적어 두므로, 어떤 스크립트에도 의존하지 않습니다.

출시 상태: Virgo는 출시 준비 단계에 있습니다. 이 문서 스냅숏 시점에 공개로 내려받을 수 있는 설치 프로그램은 없습니다. 아래 운영자 예시는 이미 전달받아 검증한 preview 릴리스가 있다고 전제합니다. 다운로드 안내도, 일반 공급 발표도 아닙니다.

설치 계약

공용 권한과 지속 기록을 위해 Hub를 설치합니다. provider 대화를 실행할 머신마다 Host를 설치하거나 등록합니다. Hub와 Host는 같은 머신에서 돌 수도 있고, Host가 원격 Hub에 연결할 수도 있습니다.

Hub/Host 설치와 업데이트는 공용 MCP, skill, 규칙, Ponytail, memory, Graphify 리소스와 그 지원 연결을 함께 공급해야 합니다. 사용자가 그 프로젝트들을 따로 클론하거나, 기능마다 두 번째 서버를 설치하거나, Seat마다 손으로 배선할 필요는 없어야 합니다. 기능 정책과 provider 로그인·신뢰 설정은 기능을 설치하는 일과는 별개입니다.

목표 완료 확인은 Virgo 루트 아래에서 평범한 지원 대화를 열고, 인가된 Seat을 claim하고, 네이티브 메시지를 받는 것입니다. 새 대화로 이를 반복할 때 새 Seat 파일이나 Host 재시작이 필요해서는 안 됩니다.

현재 preview 소스는 그 여정을 아직 끝내지 못합니다. 자동 공용 provider 설정, 동적 claim attachment, 전체 기능 배선, 자동 Host 간 업데이트는 구현 공백으로 남아 있습니다.

설치에 필요한 것

정확한 아티팩트 식별자와 manifest를 갖춘 호환 Virgo 릴리스.
네이티브 런타임과 CLI가 쓸 수 있는 Bun. 릴리스가 시험한 런타임 버전을 쓰세요. TypeScript 타입 패키지의 버전은 런타임 요건이 아닙니다.
로컬 Hub의 PostgreSQL과 JetStream 서비스를 설치하는 머신에서는 Docker와 사용 가능한 서비스 포트. 원격 Host는 이 데이터베이스에 직접 연결하지 않고 Hub API를 사용합니다.
선택한 Virgo 루트(보통 ~/virgo)에 대한 쓰기 권한과 선택한 릴리스 소스에 대한 읽기 권한.
그 대화를 실행할 머신에서의 지원되는 provider 실행 파일, provider 계정 접근, 필요한 신뢰 설정.
원격 Host의 경우, 접근 가능한 HTTPS Hub 엔드포인트와 인가된 Host 등록. 네트워크 연결만으로 Virgo 정체성이 성립하지는 않습니다.

아티팩트가 있는지는 선택한 운영체제와 아키텍처에 대해 확인해야 합니다. 소스의 플랫폼 확인이 그에 대응하는 공개 바이너리가 출시되었음을 증명하지는 않습니다.

현재 preview: 로컬 Hub 설치

이것은 구현된 CLI에 대한 운영자용 참고 자료입니다. 자리표시자 값은 preview용으로 전달받아 검증한 릴리스와 manifest 디렉터리로 바꾸세요. 이 명령은 로컬 Hub를 만듭니다. 설정되지 않은 provider Seat을 준비 상태로 만들지 않으며, 위의 통합 기능 승인을 완료하지도 않습니다.

VIRGO_BIN="/absolute/path/to/verified-release/bin/virgo"
VIRGO_ROOT="$HOME/virgo"
VIRGO_RELEASE="REPLACE_WITH_EXACT_RELEASE_ID"
VIRGO_MANIFESTS="/absolute/path/to/verified-manifests"
VIRGO_MACHINE="my-machine"

"$VIRGO_BIN" install --mode local \
  --root "$VIRGO_ROOT" \
  --release "$VIRGO_RELEASE" \
  --machine "$VIRGO_MACHINE" \
  --manifest-directory "$VIRGO_MANIFESTS"

배포 출처는 정확히 하나만 쓰세요. 인가된 preview 운영자는 해당 릴리스 저장소에 접근 권한이 있을 때 --manifest-directory를 --github-repository virgo-codes/virgo-release로 바꿀 수 있습니다. 이는 배포 출처에 대한 접근이지, 공개 다운로드가 가능하다는 증거가 아닙니다.

설치 프로그램은 정확한 installationDirectory를 반환합니다. 그 값과 선택한 릴리스·계획 영수증을 보존하세요. 인코딩된 인스턴스 경로를 손으로 만들지 마세요. 설치본은 자기 루트 아래의 데이터베이스 저장을 소유하며, 활성화 전에 선택한 아티팩트를 검증합니다.

위의 로컬 preview는 새로운 추가 Host 설치·업데이트 절차와는 별개입니다. 그 절차는 기존 Hub와 정본 릴리스 부트스트랩을 사용해 install --mode host로 진행합니다. 소스 구현과 격리된 설치 테스트는 존재하지만, 이 스냅숏 시점에는 대응하는 CLI·부트스트랩·릴리스 메타데이터의 발행이 아직 필요합니다. 그 명령들을 예전 릴리스에 대고 실행하지 마세요.

현재 preview의 공백

경계	현재 상태
같은 머신의 Host	로컬 설치 프로그램은 운영자가 준비한 adapter와 Host 설정 파일로 Host를 추가로 만들 수 있습니다. 이것이 현재 preview 경로이며, 준비 작업이 필요 없는 의도된 Seat 흐름은 아닙니다.
provider MCP 설정	생성된 등록 자료는 여전히 외부 provider 등록과 설정된 principal을 요구합니다. 생성된 파일은 살아 있는 MCP 연결이 아닙니다.
평범한 Seat claim	기존 provider/세션 binding이 여전히 선행 조건입니다. claim을 우선하는 완전한 동적 경로는 아직 남아 있습니다.
통합 기능	함께 담긴 코드와 리소스만으로는 자동 설치와 동작하는 네이티브 훅, memory 파생, Graphify 조회가 성립하지 않습니다.
다중 Host 업데이트	로컬 패키지 설치는 있지만, 자동 전파와 재연결 수렴은 아직 승인되지 않았습니다.

이 공백들은 구현과 릴리스 승인에 속합니다. 제품을 따로따로 설치하는 플러그인 모음으로 다시 정의하지 않습니다.

완료를 아래에서부터 검증하기

설치된 아티팩트와 설정이 선택한 릴리스와 일치하는지 검증합니다.
정확히 어느 프로세스가 도는지와 그 프로토콜 상태를 확인합니다.
provider가 공용 MCP와 기대한 도구를 실제로 발견하는지 확인합니다.
인가된 Seat을 claim하고 그 실제 세션, Host, 전달 상태를 확인합니다.
새 네이티브 메시지를 보내고, 그 세션에서 수신을 관찰하고, 회신 관계를 검증합니다. 필요한 재연결 사례를 반복합니다.
활성화된 기능마다 실제 진입점에서 실행해 봅니다. 지침 주입, 캡처부터 복원까지의 memory, 조회까지 이어지는 저장소 추출입니다.

설치 상태가 active라거나 HTTP 상태 응답이 돌아온다는 것은 그 경계만 증명합니다. 전체 점검은 운영과 검증을 보세요.