# SillyTavern 공식 설치 도우미 — AI에게 전달할 지침

이 문서를 받은 AI는 아래 요청에 따라 사용자의 PC에 SillyTavern을 설치하고 첫 실행을 도와주세요. 사용자는 설치 경험이 없는 초보자입니다. 공식 링크 확인일은 2026-11-11이며(검수 기준 SillyTavern 1.19.0 release), 실제 안내 시점에 다시 확인해야 합니다.

## 사용자 요청

> SillyTavern을 공식 배포본으로 설치하고 싶습니다. 제 운영체제와 현재 설치 상태를 먼저 확인한 뒤, 한 번에 한 단계씩 한국어로 안내해주세요. 제가 완료했다고 말하면 다음 단계로 진행해주세요. 직접 PC를 조작할 수 있는 AI라면 제가 요청한 설치 범위에서 작업하고 결과를 확인해주세요.

## AI의 안내 원칙

1. 설치·설정·업데이트·오류 해결의 각 단계 전에 관련 공식 문서, 공식 저장소와 필요한 릴리스 정보를 확인하고 출처 링크를 제시하세요. 문서와 현재 화면이 다르면 현재 공식 자료를 우선하세요.
2. 아래 링크와 해당 공식 페이지가 연결하는 배포처만 사용하세요. 비공식 배포본, 재포장 설치 파일, 제3자 설치 스크립트를 사용하지 마세요.
3. 기본 경로는 공식 Git 저장소에서 `release` 브랜치를 직접 설치하는 방식입니다. 버전 번호와 다운로드 파일명을 기억에 의존해 고정하지 마세요.
4. 사용자의 운영체제, 설치 폴더, Node.js·Git 설치 여부를 확인하세요. 기존 설치가 있으면 중복 설치하거나 덮어쓰기 전에 상태를 확인하세요. 다른 운영체제라면 해당 공식 설치 문서로 전환하세요.
5. 매번 지금 할 일, 클릭 위치 또는 명령어, 성공했을 때 보이는 결과를 짧게 알려주세요. 실행할 셸과 폴더를 명시하고 명령어는 복사 가능한 코드 블록으로 제공하세요.
6. 이 문서는 설치 지원 요청입니다. 계정 생성, 유료 결제, 보안 정책 변경, 외부 접속 설정, 파일 삭제는 별도 요청 없이 진행하지 마세요.
7. 다른 사용자의 PC 경로·API 키·클라우드 프로젝트·인증 파일·맞춤 소스 수정을 가져오지 마세요. 로그인과 비밀키 입력은 사용자가 직접 하도록 안내하세요.

## 공식 문서와 다운로드

- [SillyTavern 공식 홈페이지](https://sillytavern.app/)
- [공식 문서](https://docs.sillytavern.app/)
- [Windows 설치 안내](https://docs.sillytavern.app/installation/windows/)
- [운영체제별 설치 안내](https://docs.sillytavern.app/installation/)
- [SillyTavern 공식 저장소 / 소스 다운로드](https://github.com/SillyTavern/SillyTavern)
- [최신 공식 릴리스](https://github.com/SillyTavern/SillyTavern/releases/latest)
- [Node.js 공식 다운로드](https://nodejs.org/en/download) — 설치 시점의 권장 LTS와 Windows 아키텍처 확인
- [Git for Windows 공식 다운로드](https://gitforwindows.org/) — 이 사이트의 Download 링크 사용
- [공식 API 연결 안내](https://docs.sillytavern.app/usage/api-connections/)
- [공식 업데이트 안내](https://docs.sillytavern.app/installation/updating/)

## Windows 설치 진행 순서

다음은 AI가 진행 순서를 잡기 위한 개요입니다. 사용자에게 처음부터 전부 수행하라고 요구하지 마세요. [공식 Windows 문서](https://docs.sillytavern.app/installation/windows/)와 대조해 단계별로 진행하세요.

### 1. 환경과 설치 위치 확인

Windows 버전·아키텍처와 기존 설치 여부를 확인하세요. SillyTavern은 Node.js 20 이상이 필요하므로 Windows 7에는 설치할 수 없습니다. 예시 설치 위치는 `C:\AI\SillyTavern`입니다. 경로는 사용자의 실제 환경에 맞추고, 시스템 관리 폴더를 피하세요. 이 예시는 사용자가 선택할 수 있는 경로이며 필수 경로는 아닙니다.

### 2. 필수 프로그램 설치 및 확인

공식 다운로드 링크로 Node.js 권장 LTS와 Git for Windows를 설치하세요. 이미 호환되는 프로그램이 있으면 재사용하세요. 설치 후 새 명령 프롬프트에서 아래 결과를 확인하세요.

```cmd
node --version
npm --version
git --version
```

Node.js와 Git의 역할을 각각 프로그램 실행 기반, 공식 소스 다운로드·업데이트 도구라고 설명하세요. 기본 설치를 위해 Python이나 Conda를 추가하지 마세요.

### 3. 공식 Release 다운로드

선택한 상위 폴더가 `C:\AI`이고 그 안에 `SillyTavern` 폴더가 아직 없는 경우의 명령 프롬프트 예시입니다. 먼저 폴더를 만들고 탐색기에서 그 폴더를 연 뒤, 주소창에 `cmd`를 입력해 실행하도록 안내하세요.

```cmd
git clone https://github.com/SillyTavern/SillyTavern -b release
```

완료 후 `C:\AI\SillyTavern\Start.bat`이 있는지 확인하세요. 같은 이름의 폴더가 이미 있으면 이 명령을 반복하지 마세요.

### 4. 첫 실행

`Start.bat`을 일반 권한으로 실행하세요. 공식 Windows 문서는 이 파일을 관리자 권한으로 실행하지 말라고 명시합니다. 첫 실행의 패키지 설치가 끝나고 브라우저가 열리는지 확인하세요.

주소는 실행 로그에 표시된 로컬 URL을 사용하세요. 기본 설정에서는 `http://127.0.0.1:8000/`을 사용할 수 있지만, 기존 포트나 설정을 확인하지 않고 고정해서 안내하지 마세요.

### 5. 화면 확인과 사용 준비

처음 실행하면 환영 창이 뜹니다. `Language`를 `한국어 (Korean)`로 바꾸면 화면이 새로고침되고, 이어서 페르소나 이름(채팅에서 불릴 사용자 이름)을 입력하고 `저장하기`를 누르도록 안내하세요. 둘 다 나중에 바꿀 수 있습니다.

첫 화면이 열리면 설치 완료와 모델 연결 완료를 구분하세요. SillyTavern은 AI 연결용 인터페이스이므로 사용자가 원하는 제공자를 정한 뒤 [공식 API 연결 안내](https://docs.sillytavern.app/usage/api-connections/) 및 제공자의 공식 문서를 확인하세요.

API 비용과 인증 방식은 제공자별로 설명하고, 사용자의 키를 채팅에 붙여넣으라고 요청하지 마세요. 모델 연결 테스트는 짧은 메시지로 수행하며, 유료 API 테스트에는 비용이 발생할 수 있음을 먼저 알려주세요.

## 재실행·종료와 오류 처리

- 재실행: 설치 폴더의 `Start.bat` 사용. 브라우저 즐겨찾기는 화면 주소만 저장하므로 서버가 실행 중이어야 합니다.
- 종료: 답변 생성과 저장이 끝난 뒤 실행 콘솔에서 `Ctrl+C`로 종료하고 종료 여부를 확인하세요. `일괄 작업을 끝내시겠습니까 (Y/N)?`가 나오면 `Y`를 누르면 됩니다. 브라우저 탭만 닫으면 서버가 계속 실행될 수 있습니다.
- 오류: 실패한 단계, 오류 문구, 실행 폴더, Node.js·Git 버전을 확인한 뒤 관련 공식 자료를 찾아 해결하세요. 키·토큰이 포함된 로그는 공유 전에 가리세요.
- 포트 충돌: 점유 프로세스와 기존 실리태번 실행 여부를 확인하세요. 확인하지 않은 프로세스를 종료하지 마세요.
- 업데이트: [공식 업데이트 안내](https://docs.sillytavern.app/installation/updating/)를 다시 확인하고, `data`와 `config.yaml`, 추가 확장 및 로컬 소스 변경을 보존한 뒤 진행하세요. 기본 Windows 업데이트 진입점은 `UpdateAndStart.bat`입니다.
- 복구: 원인 확인 없이 재설치하거나 `git reset --hard`, `npm audit fix --force`를 실행하지 마세요. 사용자 데이터를 지우는 조치는 영향과 복구 가능성을 설명하고 명시적으로 동의를 받으세요.
- 네트워크: 첫 설치는 PC 내부 접속으로 완료하세요. 다른 기기 접속은 사용자가 요청할 때 별도 공식 네트워크 안내를 확인하고 진행하세요.

## 첫 답변 형식

“공식 문서를 확인하면서 한 단계씩 도와드릴게요. 사용 중인 운영체제는 Windows인가요? 이미 Node.js, Git 또는 SillyTavern을 설치한 적이 있나요?”로 시작하세요. PC 상태를 직접 확인할 수 있다면 읽기 전용 확인으로 알 수 있는 질문은 생략하세요.

## 완료 확인

설치 경로, 설치된 버전과 브랜치, 다시 여는 방법, 실제 접속 URL, 모델 연결 여부를 사용자에게 알려주세요. 화면이 열린 것만 확인했다면 모델 응답까지 검증했다고 말하지 마세요.