실리태번을 설치하기 전에 꼭 알아둘 점은 무엇인가요?
실리태번(SillyTavern)은 흔히 보는 모바일 앱이나 단일 .exe 설치 프로그램이 아니라, Node.js로 작동하는 가벼운 로컬 웹 서버입니다. 프로그램을 켜면 뒤에서 작은 검은색 콘솔 창이 돌아가고, 실제 채팅 화면은 크롬이나 사파리 같은 웹 브라우저에서 http://localhost:8000 주소로 열립니다.
실리태번은 화면 구성과 프롬프트 조립, 채팅 기록 저장만 담당하고 실제 AI 연산은 연결된 API 서버가 처리하기 때문에 고사양 게이밍 PC나 그래픽카드(GPU)가 전혀 필요 없습니다. 사무용 노트북이나 일반 데스크톱, 요즘 나오는 안드로이드 스마트폰이라면 어디서든 가볍게 돌아갑니다. 아래의 모든 명령어와 설정값은 2026년 11월 기준 SillyTavern 공식 문서를 바탕으로 검증했습니다.
Windows PC에는 실리태번을 어떻게 설치하나요?
Windows 10이나 Windows 11에서는 Node.js와 Git을 설치한 뒤 안정 버전인 release 브랜치를 받아 구동하는 방법이 가장 깔끔하고 오류도 적습니다.
주의: 공식 Windows 설치 문서에서 강조하듯, 절대로 윈도우가 권한을 통제하는 시스템 폴더(C:\Program Files, C:\Windows\System32)나 원드라이브(OneDrive) 동기화 폴더 안에 실리태번을 설치하지 마세요. 또한 Start.bat을 우클릭해 **'관리자 권한으로 실행'**해서도 안 됩니다. 두 경우 모두 Node.js가 패키지를 설치할 때 파일 권한이 꼬여 에러가 발생합니다. (Windows 7 역시 최신 Node.js를 지원하지 않아 실행할 수 없습니다.)
Windows 단계별 설치 순서
- Node.js LTS 설치: nodejs.org에 접속해 LTS(장기 지원 버전) 설치 파일을 내려받고 기본 설정 그대로 설치합니다.
- Git for Windows 설치: gitforwindows.org에서 설치 파일을 받아 기본값 그대로 Next를 눌러 설치합니다.
- 설치할 일반 폴더 준비: 파일 탐색기(
Win + E)를 열고C:\Games나C:\AI(또는 원드라이브와 연동되지 않은 일반 사용자 폴더)처럼 깔끔한 경로로 이동합니다. - 해당 경로에서 명령 프롬프트 열기: 파일 탐색기 상단의 주소창을 마우스로 클릭한 뒤
cmd라고 치고 Enter를 누릅니다. 방금 보고 있던 그 폴더 경로에서 검은색 명령 프롬프트 창이 바로 열립니다. - 안정 버전(release) 클론하기: 열린 창에 아래 명령어를 복사해 붙여넣고 Enter를 누릅니다.
git clone https://github.com/SillyTavern/SillyTavern -b release- 실리태번 실행하기: 파일 탐색기에서 새로 만들어진
SillyTavern폴더로 들어간 뒤,Start.bat파일(확장자가 숨겨져 있다면Start)을 더블클릭합니다.
맨 처음 실행할 때는 콘솔 창에서 필요한 npm 패키지를 자동으로 내려받느라 1~2분 정도 걸리며, 설치가 끝나면 기본 웹 브라우저에서 http://127.0.0.1:8000 채팅 화면이 자동으로 열립니다.
팁: 업데이트나 백업을 명령어 대신 버튼 클릭으로 관리하고 싶다면, 공식 팀이 운영하는 SillyTavern-Launcher를 클론해 installer.bat으로 실행해 보세요. 그래픽 메뉴에서 원클릭으로 업데이트와 실행을 관리할 수 있습니다.
안드로이드(Android) 스마트폰에서 Termux로 설치하는 방법은 무엇인가요?
실리태번은 별도의 안드로이드 APK 앱이 없습니다. 대신 무료 리눅스 터미널 앱인 Termux 안에서 PC와 완전히 동일한 Node.js 서버를 돌리고, 스마트폰의 크롬(Chrome), 파이어폭스, 브레이브 브라우저에서 화면을 열어 플레이합니다.
주의: 구글 플레이스토어(Google Play Store)에 있는 Termux는 절대 설치하지 마세요. 실리태번 공식 안드로이드 가이드에서도 경고하듯, 플레이스토어 버전은 오래전에 업데이트가 끊겨 패키지 저장소가 작동하지 않습니다. 이미 플레이스토어 버전을 깔았다면 먼저 삭제한 뒤 아래 방법으로 다시 설치하세요.
안드로이드 (Termux) 단계별 설치 순서
- F-Droid 또는 GitHub에서 Termux 설치: F-Droid(권장) 또는 Termux 공식 GitHub Releases에서 APK 파일을 내려받아 설치합니다.
- 패키지 미러 선택 및 업데이트: Termux를 열고 미러 서버를 고른 뒤 기본 패키지를 모두 최신 버전으로 올립니다(중간에 물어보는 창이 나오면
Y를 입력하고 Enter를 누르세요).
termux-change-repo
pkg update && pkg upgrade- Git, Node.js LTS, Nano 설치: 아래 명령어를 정확히 입력해 필수 도구 3가지를 설치합니다.
pkg install git nodejs-lts nano- 실리태번 내려받기: Termux 홈 디렉터리에 안정 버전인
release브랜치를 클론합니다.
git clone https://github.com/SillyTavern/SillyTavern -b release- 서버 켜기: 실리태번 폴더로 이동해 시작 스크립트를 실행합니다.
cd ~/SillyTavern
bash start.sh콘솔 화면에 SillyTavern is listening on IPv4: 127.0.0.1:8000이라는 문구가 뜨면, 스마트폰 웹 브라우저를 켜고 주소창에 http://localhost:8000을 입력해 접속하세요.
모바일에서 튕김과 먹통을 막아주는 필수 설정 2가지
- Termux Wakelock(절전 방지) 켜기: 안드로이드는 배터리 절약을 위해 백그라운드 앱을 강제로 종료시키는 경향이 강합니다. 스마트폰 상단 알림창을 쓸어내려 Termux 알림을 찾은 뒤
Acquire wakelock버튼을 눌러 두세요. 그래야 브라우저에서 열심히 채팅을 치는 도중에 뒤에서 서버가 잠들어 버리지 않습니다. 추가로 안드로이드 설정의 애플리케이션 정보에서 Termux 배터리 사용량을 '제한 없음'으로 바꿔주시면 더 안정적입니다. - 캐릭터 카드가 많다면 지연 로딩(Lazy Load) 켜기: 폰에 캐릭터 카드를 수백 장씩 넣어두고 쓴다면, Termux에서
nano ~/SillyTavern/config.yaml을 실행해performance:항목 아래의lazyLoadCharacters: true와useDiskCache: false로 수정하세요(Ctrl + X→Y→Enter순서로 저장). 초기 로딩 속도와 메모리 점유율이 훨씬 쾌적해집니다.
아이폰(iPhone)이나 아이패드에서는 실리태번을 어떻게 쓰나요?
애플 iOS는 보안 정책상 백그라운드에서 로컬 Node.js 서버를 돌리는 것을 허용하지 않습니다. 따라서 아이폰이나 아이패드 기기 자체에는 실리태번을 직접 설치할 수 없습니다. 대신 다른 곳(내 PC나 클라우드)에 실리태번을 켜 두고 아이폰 사파리(Safari)로 접속해 사용하며, 화면 레이아웃은 모바일 크기에 맞춰 자동으로 깔끔하게 변환됩니다.
플레이 환경에 따라 아래 세 가지 방법 중 하나를 고르시면 됩니다.
방법 1: 집 PC에 실리태번을 켜 두고 집 와이파이로 아이폰에서 접속하기 (무료·최고의 보안)
집에서 컴퓨터를 켜 둔 상태로 침대나 소파에 누워 아이폰으로 플레이하고 싶을 때 가장 좋은 방법입니다.
- 먼저 PC에서 실리태번을 최소 한 번 실행해 설정 파일이 만들어지게 한 뒤, 서버 창을 닫습니다.
- 메모장 같은 텍스트 편집기로 실리태번 폴더 바로 아래에 있는
/SillyTavern/config.yaml파일을 엽니다. (주의:/SillyTavern/default/config.yaml이 아니라 반드시 루트 경로의/SillyTavern/config.yaml을 수정해야 합니다.) - 공식 원격 접속 가이드에 따라
listen: false를listen: true로 바꿉니다. - 접속 제어 설정하기 (필수): 보안을 위해 실리태번은
listen: true를 켰을 때 IP 화이트리스트나 비밀번호 잠금 중 하나라도 설정되어 있지 않으면 아예 서버 시작을 거부합니다. 집 와이파이에서 쓸 때는config.yaml의whitelist:항목을 찾아 아래와 같이 로컬 공유기 대역을 추가해 주는 것이 가장 편합니다.
listen: true
whitelistMode: true
whitelist:
- ::1
- 127.0.0.1
- 192.168.0.0/16
- 10.0.0.0/8
- 172.16.0.0/12- 내 PC의 내부 IPv4 주소를 확인합니다. 키보드에서
Win + R을 누르고cmd를 입력한 뒤,ipconfig를 쳐서 나오는 IPv4 주소(예:192.168.1.25)를 메모해 두세요. - PC에서 실리태번을 다시 켜고(Windows 방화벽 창이 뜨면 개인 네트워크 허용 체크), 집 와이파이에 연결된 아이폰 Safari 주소창에
http://192.168.1.25:8000을 입력합니다(https://가 아니라 반드시http://로 접속해야 합니다).
방법 2: 집 밖(LTE/5G)에서 Tailscale로 집 PC에 안전하게 접속하기 (무료·보안 권장)
외부에서 접속하겠다고 집 공유기에서 8000번 포트를 공인 인터넷으로 그냥 열어버리는(포트포워딩) 것은 매우 위험합니다. 카페나 이동 중에 모바일 데이터로 집 PC의 실리태번에 붙고 싶다면, 실리태번 공식 터널링 가이드가 권장하는 무료 개인 메쉬 VPN인 Tailscale을 쓰세요.
- 집 PC와 아이폰(앱스토어)에 각각 Tailscale을 설치하고 같은 계정으로 로그인합니다.
- PC의
/SillyTavern/config.yaml파일에서listen: true,whitelistMode: false로 바꾸고 아이디·비밀번호 잠금(basicAuthMode: true)을 켭니다.
listen: true
whitelistMode: false
basicAuthMode: true
basicAuthUser:
username: "yourname"
password: "a-strong-password"- PC에서 실리태번을 재시작합니다. 아이폰에서 Tailscale 앱을 켜고 집 PC에 할당된 Tailscale IP(
100.x.y.z형태)를 복사한 뒤, Safari에서http://100.x.y.z:8000으로 접속해 아이디와 비밀번호를 입력하면 됩니다.
방법 3: 클라우드 서버에 올리기 ('클라우드 실리태번')
개인 PC가 없거나 컴퓨터를 계속 켜 두기 부담스럽다면 소형 클라우드 VPS를 빌려 실리태번을 돌릴 수도 있습니다(커뮤니티에서 흔히 '클라우드 실리태번'이라고 부르는 방식입니다).
- 장점: PC를 켜 두지 않아도 24시간 언제 어디서나 아이폰·아이패드로 바로 접속할 수 있습니다.
- 비용과 개인정보 주의사항: 개인 VPS를 직접 빌리면 월 몇 달러의 서버 비용이 들고 기본적인 리눅스 명령어를 다뤄야 합니다. 특히 남이 세팅해 놓고 저렴하게 분양하는 비공식 '공유 클라우드 실리태번'은 각별히 조심하세요. 서버 관리자는 언제든 내
data/폴더를 열어 사적인 채팅 로그, 캐릭터 카드, 심지어 저장해 둔 유료 API 키까지 전부 들여다볼 수 있습니다. 클라우드를 쓰더라도 반드시 본인 명의의 단독 VPS를 빌리고, HTTPS와basicAuthMode: true비밀번호 잠금을 걸어 두세요.
실리태번을 처음 켜면 보이는 상단 아이콘 9개는 각각 무슨 역할인가요?
http://localhost:8000을 처음 열면 화면 맨 위에 아이콘 9개가 나란히 보입니다. 처음엔 복잡해 보이지만 왼쪽부터 오른쪽 순서대로 역할만 알면 아주 간단합니다.
| 순서 | 공식 영문 명칭 | 아이콘 모양 | 한줄 핵심 역할 |
|---|---|---|---|
| 1 | AI Response Configuration | 가로 슬라이더 3개 | 답변 길이와 온도(Temperature)를 조절하고, 프리셋을 불러와 프롬프트 블록을 켜고 끄는 Chat Completion Prompt Manager가 있는 곳입니다. |
| 2 | API Connections | 전기 플러그 | 실리태번에 AI 모델을 연결하는 탭입니다. 여기서 Chat Completion을 고르고 엔드포인트 주소와 API 키를 넣은 뒤 모델을 선택합니다. |
| 3 | Advanced Formatting | 대문자 A | 로컬 Text Completion 모델용 템플릿 설정입니다. Claude, Gemini, DeepSeek처럼 Chat Completion API를 쓸 때는 건드릴 필요가 없습니다. |
| 4 | World Info | 책 위의 지구본 | 대화 중 특정 키워드가 나올 때만 세계관 설정을 프롬프트에 넣어주는 **로어북(Lorebook)**을 만들고 불러오는 곳입니다. |
| 5 | User Settings | 톱니바퀴와 사람 | 화면 테마, 글꼴 크기, 말풍선 스타일, 단축키 등 인터페이스 외형을 내 취향대로 꾸밉니다. |
| 6 | Backgrounds | 액자 속 풍경화 | 채팅창 뒤에 깔리는 배경 이미지를 바꿉니다. |
| 7 | Extensions | 3D 정육면체 블록 3개 | 정규식(Regex) 스크립트, 대화 요약, 이미지·음성 첨부 같은 내장 도구와 외부 GitHub 플러그인을 관리합니다. |
| 8 | Persona Management | 웃는 얼굴 | 이야기 속 {{user}}(플레이어)의 이름, 프로필 사진, 캐릭터 설정을 적어두고 채팅방마다 다른 페르소나를 지정합니다. |
| 9 | Characters | 명함첩 (맨 오른쪽) | .png나 .json 형식의 캐릭터 카드를 불러오고, 새 대화를 시작하거나 다인 그룹 채팅을 만드는 캐릭터 목록 창입니다. |
API를 연결하고 첫 롤플레잉 대화를 시작하려면 어떻게 해야 하나요?
실리태번에는 기본 AI 모델이 들어 있지 않으므로, 첫 메시지를 보내기 전에 상단 두 번째에 있는 플러그 아이콘(API Connections)부터 열어야 합니다. TavernAPI를 연결하고 전용 롤플레잉 프리셋을 불러오는 과정은 2분이면 끝납니다.
- API Connections(플러그 아이콘) 열기: API를
Chat Completion으로 맞추고, Chat Completion Source는Custom (OpenAI-compatible)으로 선택합니다. - 엔드포인트 주소와 API 키 입력하기:
- Custom Endpoint (Base URL):
https://tavernapi.com/v1(끝에/chat/completions를 붙이지 마세요) - Custom API Key: TavernAPI 콘솔에서 발급받은
sk-tav-...키를 붙여넣습니다.
- Custom Endpoint (Base URL):
- 연결 및 모델 선택: Connect 버튼을 누른 뒤, Available Models 드롭다운을 열어
gemini-4-argon,claude-opus-5.5,deepseek-v4-pro등 1M 컨텍스트를 지원하는 5개 공식 모델 중 하나를 고릅니다(어떤 모델이 내 취향에 맞을지 고민된다면 롤플레잉 AI 모델 상세 비교 및 추천 글을 먼저 읽어보세요). - TavernAPI 프리셋 불러오기: 콘솔에서 프리셋 JSON 파일을 내려받은 뒤, 실리태번 맨 왼쪽 슬라이더 아이콘(AI Response Configuration)을 열고 Chat Completion Presets 옆의 Import 버튼을 눌러 파일을 불러옵니다. 프롬프트 목록에서 출력 분량, 한국어 출력, 유저 사칭 방지 같은 스위치는 내 입맛대로 켜고 끌 수 있으며, 서버 잠금 핵심 블록(
[[tav:...]])은 우리 게이트웨이에서 자동 프롬프트 캐싱과 함께 알아서 펼쳐집니다.
연결 도중 401, 402, 429 같은 오류 코드가 뜨거나 더 자세한 설정법이 궁금하다면 실리태번 API 상세 연동 및 오류 해결 가이드와 서버 잠금 RP 프리셋 작동 원리를 참고하시고, 다른 프론트엔드와의 비교는 2026년 AI 롤플레잉 툴 비교 가이드, 토큰 단가는 요금 및 모델 페이지와 FAQ에서 확인해 보세요.