DOCS · GETTING STARTED

설치부터 첫 에이전트 실행까지

사전 빌드된 체험판 패키지로 Vantisso를 직접 설치하고 브라우저 관리 콘솔에서 첫 AI 에이전트를 띄워 대화해 보는 전 과정을 안내합니다. Go 툴체인 설치나 소스 체크아웃은 필요 없으며 최초 실행 시점부터 30일 동안 모든 기능을 제한 없이 평가할 수 있습니다.

최종 수정 · 2026년 7월 16일

1 · 준비 사항

Vantisso는 하드웨어 가상화(KVM) 위에서 MicroVM을 띄워 에이전트를 격리 실행하므로 리눅스 호스트에서 동작합니다. 시작하기 전에 호스트가 아래 요구사항을 만족하는지 확인하세요.

FULL 과 SLIM 중 선택

릴리스마다 두 가지 패키지가 제공됩니다. 처음 사용한다면 가장 간단한 FULL 을 권장합니다.

아래 명령으로 런타임 패키지를 설치합니다. SLIM을 쓸 때만 두 번째 줄에 있는 명령 실행이 필요합니다.

# Runtime packages (both variants)
sudo apt-get install -y iproute2 dmsetup iptables

# SLIM package only — the first boot builds the VM image
sudo apt-get install -y curl util-linux e2fsprogs coreutils

2 · 체험판 다운로드

Vantisso 체험판은 공개 릴리스 저장소에서 받습니다. 패키지 안에는 최초 실행 시점부터 30일 동안 유효한 평가 라이선스가 함께 들어 있어, 별도 키 발급 절차 없이 바로 시작할 수 있습니다.

터미널에서 바로 받고 무결성까지 확인하려면 다음 명령을 사용하세요. 함께 제공되는 .sha256 체크섬으로 내려받은 파일이 온전한지 검증합니다.

# Download the FULL package and its checksum, then verify
curl -LO https://github.com/ax-onn/vantisso-releases/releases/download/eval01-rc1/vantisso-eval01-linux-amd64-full.tar.gz
curl -LO https://github.com/ax-onn/vantisso-releases/releases/download/eval01-rc1/vantisso-eval01-linux-amd64-full.tar.gz.sha256
sha256sum -c vantisso-eval01-linux-amd64-full.tar.gz.sha256

3 · 설치

내려받은 패키지를 풀고 대화형 설치 스크립트를 실행합니다.

tar xzf vantisso-eval01-linux-amd64-full.tar.gz
cd vantisso-eval01
sudo ./install.sh

설치 스크립트는 대화형으로 다음 단계를 진행합니다.

1. 사전 점검 — amd64·/dev/kvm·런타임 도구(그리고 SLIM이면 이미지 빌드 도구)를 확인하고, 빠진 것이 있으면 명확한 메시지와 함께 중단합니다.
2. 설치 — 바이너리와 설정 템플릿을 데몬 작업 디렉터리인 /opt/vantisso 에 배치합니다.
3. LLM 설정 — 사용할 프로바이더(google / anthropic / openai / groq)·모델·API 키를 입력받아 configs/vantisso.yaml 과 vantisso-secrets.yaml(권한 0600)에 기록합니다.
4. API 토큰 — 컨트롤 플레인 접근용 토큰 생성을 제안합니다.(vantisso.env 에 저장)
5. 서비스 등록 — systemd 서비스(vantisso)로 등록·활성화하고 시작합니다.

설치가 끝나면 관리 콘솔과 서비스에 다음 위치로 접근합니다.

4 · 첫 에이전트 실행

이제 브라우저 관리 콘솔에서 에이전트를 하나 띄우고 대화해 봅니다. 명령줄 없이 클릭만으로 진행됩니다.

1. 브라우저에서 `http://localhost:3000/ui/` 를 엽니다. 설치 때 API 토큰을 만들었다면 그 토큰을 입력하고 로그인(Sign in), 토큰을 두지 않았다면 곧바로 콘솔로 들어갑니다.
2. 상단에 ”체험판 라이선스 — N일 남음(Evaluation license — N days left)” 배너로 남은 평가 기간이 표시됩니다. 기본 화면은 운영자(Operator) 플레인의 VM 목록(VMs) 탭입니다.
3. VM 생성(Create VM) 을 눌러 프로파일(Profile)(설치 때 정한 프로바이더·모델이 기본 프로파일로 준비되어 있음)을 선택하고 생성(Create) 합니다. 새 VM이 목록에 나타나 상태가 생성 중(spawning) → 준비됨(ready) 으로 바뀝니다.(보통 1초 이내)
4. 목록에서 그 VM을 클릭해 상세 화면으로 들어가면 대화(Conversation) 패널이 있습니다. 메시지를 입력하고 보내기(Send) 버튼을 누르면 에이전트가 응답합니다. 예: Say hello and list the tools you can use.
5. 간단한 실험 테스트가 끝나면 VM 상세의 VM 삭제(Delete VM) 로 정리합니다. Vantisso는 태생적으로 일시적(ephemeral)이라 VM·네트워크·디스크가 흔적 없이 회수됩니다.

5 · 다음 단계

• 사용자 가이드 — 프로파일·스냅샷·MCP 게이트웨이·팀 협업 등 핵심 기능을 개념과 함께 자세히 설명합니다.
• API 레퍼런스 — 자체 애플리케이션이나 기업 IT 운영 포털에서 Vantisso를 제어·관리하는 REST API 명세입니다.
• 평가 기간 종료 후 — 기존 에이전트 VM에 대한 조회·태스크 실행·삭제 기능은 계속 사용가능하지만 신규 VM·에이전트 그룹 생성 기능 실행은 불가능합니다.(403 trial_expired 에러 발생) 라이선스 만료 전 잔여 기간은 콘솔 상단 배너에서 언제든 확인 가능합니다.