Readme i18n

SillyTavern/SillyTavern

Share
English(original)DeutschEspañolfrançais日本語한국어PortuguêsРусский中文
Last translated: 16 Jun 2025

Translation Not Available Yet

This repository's README hasn't been translated yet. Once translated, it will be easier to read and understand in your native language (中文).

After translating, add the links to README so others can view it directly.

SillyTavern은 다양한 LLM API(KoboldAI/CPP, Horde, NovelAI, Ooba, Tabby, OpenAI, OpenRouter, Claude, Mistral 등)를 위한 통합 인터페이스, 모바일 친화적인 레이아웃, 비주얼 노벨 모드, Automatic1111 & ComfyUI API 이미지 생성 통합, TTS, WorldInfo(로어북), 사용자 정의 가능한 UI, 자동 번역, 필요한 모든 프롬프트 옵션, 그리고 서드파티 확장을 통한 무한한 성장 잠재력을 제공합니다.

대부분의 질문과 시작을 돕기 위해 문서 웹사이트가 있습니다.

SillyTavern이란?

SillyTavern(줄여서 ST)은 텍스트 생성 LLM, 이미지 생성 엔진, TTS 음성 모델과 상호작용할 수 있는 로컬 설치형 사용자 인터페이스입니다.

2023년 2월 TavernAI 1.2.8의 포크로 시작된 SillyTavern은 현재 200명 이상의 기여자와 2년간의 독자적인 개발을 거쳐, AI 애호가들을 위한 선도적인 소프트웨어로 자리매김하고 있습니다.

우리의 비전

  1. 사용자들이 LLM 프롬프트에 대한 최대한의 유틸리티와 제어권을 가질 수 있도록 하는 것이 목표입니다. 가파른 학습 곡선도 즐거움의 일부입니다!
  2. 온라인 또는 호스팅 서비스를 제공하지 않으며, 사용자 데이터를 프로그래밍 방식으로 추적하지 않습니다.
  3. SillyTavern은 LLM 애호가들의 열정적인 커뮤니티가 제공하는 프로젝트이며, 항상 무료이고 오픈 소스로 유지될 것입니다.

브랜치

SillyTavern은 모든 사용자에게 원활한 경험을 제공하기 위해 두 가지 브랜치 시스템으로 개발되고 있습니다.

  • release -🌟 대부분의 사용자에게 권장됩니다. 가장 안정적이고 권장되는 브랜치로, 주요 릴리스가 푸시될 때만 업데이트됩니다. 대부분의 사용자에게 적합합니다. 일반적으로 월 1회 업데이트됩니다.
  • staging - ⚠️ 일반적인 사용에는 권장되지 않습니다. 최신 기능을 포함하고 있지만 언제든지 문제가 발생할 수 있으므로 주의가 필요합니다. 파워 사용자와 애호가를 위한 브랜치입니다. 하루에 여러 번 업데이트됩니다.

git CLI 사용에 익숙하지 않거나 브랜치가 무엇인지 이해하지 못한다면 걱정하지 마세요! 릴리스 브랜치가 항상 더 나은 선택입니다.

SillyTavern 외에 무엇이 필요한가요?

SillyTavern은 인터페이스일 뿐이므로, 추론을 제공할 LLM 백엔드에 대한 접근이 필요합니다. AI Horde를 사용하면 즉시 사용 가능한 채팅을 즐길 수 있습니다. 그 외에도 많은 로컬 및 클라우드 기반 LLM 백엔드를 지원합니다: OpenAI 호환 API, KoboldAI, Tabby 등. 지원되는 API에 대한 자세한 내용은 문서에서 확인할 수 있습니다.

SillyTavern을 실행하려면 강력한 PC가 필요한가요?

하드웨어 요구 사항은 최소한입니다: NodeJS 18 이상을 실행할 수 있는 모든 기기에서 실행됩니다. 로컬 머신에서 LLM 추론을 수행하려는 경우, 최소 6GB VRAM이 있는 NVIDIA 3000 시리즈 그래픽 카드를 권장합니다. 자세한 내용은 백엔드 문서를 확인하세요.

추천 백엔드 (제휴 없음)

  • AI Horde - 자원봉사자들이 호스팅하는 모델을 사용합니다. 추가 설정이 필요 없습니다.
  • KoboldCpp - GGUF 모델을 로컬에서 실행하기 위한 커뮤니티의 최애
  • tabbyAPI - 인기 있는 경량의 로컬 호스팅 exl2 추론 API
  • OpenRouter - 많은 클라우드 제공업체(OpenAI, Claude, Meta Llama 등)와 인기 있는 커뮤니티 모델을 위한 단일 API

질문이나 제안이 있나요?

디스코드 서버

디스코드 커뮤니티에 참여하세요! 지원을 받고, 좋아하는 캐릭터와 프롬프트를 공유하세요.

또는 개발자와 직접 연락하세요:

프로젝트가 마음에 듭니다! 어떻게 기여할 수 있나요?

  1. 풀 리퀘스트를 보내세요. 기여 방법 배우기: CONTRIBUTING.md
  2. 제공된 템플릿을 사용하여 기능 제안과 이슈 보고서를 보내세요.
  3. 이 전체 readme 파일을 읽고 문서 웹사이트를 먼저 확인하여 중복 이슈를 방지하세요.

스크린샷

image image

캐릭터 카드

SillyTavern은 "캐릭터 카드" 개념을 중심으로 구축되었습니다. 캐릭터 카드는 LLM의 행동을 설정하는 프롬프트 모음이며, SillyTavern에서 지속적인 대화를 위해 필요합니다. ChatGPT의 GPTs나 Poe의 봇과 유사하게 기능합니다. 캐릭터 카드의 내용은 무엇이든 될 수 있습니다: 추상적인 시나리오, 특정 작업에 맞춰진 어시스턴트, 유명 인물 또는 가상의 캐릭터.

캐릭터 카드를 선택하지 않고 빠르게 대화하거나 LLM 연결을 테스트하려면, SillyTavern을 열고 환영 화면의 입력 바에 프롬프트를 입력하세요. 이렇게 하면 나중에 사용자 정의할 수 있는 빈 "어시스턴트" 캐릭터 카드가 생성됩니다.

캐릭터 카드를 정의하는 방법에 대한 일반적인 아이디어를 얻으려면 기본 캐릭터(Seraphina)를 참조하거나 "Download Extensions & Assets" 메뉴에서 커뮤니티 제작 카드를 다운로드하세요.

주요 기능

  • 많은 커뮤니티 제작 프리셋이 포함된 고급 텍스트 생성 설정
  • World Info 지원: 풍부한 로어를 생성하거나 캐릭터 카드의 토큰을 절약하세요
  • 그룹 채팅: 여러 봇이 참여하는 방에서 캐릭터들이 당신과/또는 서로에게 말할 수 있습니다
  • 풍부한 UI 사용자 정의 옵션: 테마 색상, 배경 이미지, 사용자 정의 CSS 등
  • 사용자 페르소나: AI가 당신에 대해 조금 알 수 있도록 하여 몰입감을 높이세요
  • 내장된 RAG 지원: AI가 참조할 수 있도록 채팅에 문서를 추가하세요
  • 광범위한 채팅 명령 하위 시스템과 자체 스크립팅 엔진

확장 기능

SillyTavern은 확장성을 지원합니다.

  • 캐릭터 감정 표현(스프라이트)
  • 채팅 기록 자동 요약
  • UI 및 채팅 자동 번역
  • Stable Diffusion/FLUX/DALL-E 이미지 생성
  • AI 응답 메시지에 대한 텍스트-음성 변환(ElevenLabs, Silero 또는 OS의 시스템 TTS 통해)
  • 프롬프트에 추가적인 현실 세계 컨텍스트를 추가하기 위한 웹 검색 기능
  • "Download Extensions & Assets" 메뉴에서 다운로드할 수 있는 더 많은 기능들

사용 방법에 대한 튜토리얼은 문서에서 찾을 수 있습니다.

⌛ 설치

🪟 Windows

[!WARNING]

  • 윈도우 제어 폴더(Program Files, System32 등)에 설치하지 마세요.
  • 관리자 권한으로 START.BAT을 실행하지 마세요
  • 윈도우 7에서는 NodeJS 18.16을 실행할 수 없으므로 설치가 불가능합니다

Git을 통한 설치(권장)

  1. NodeJS 설치(최신 LTS 버전 권장)
  2. Git for Windows 설치
  3. Windows 탐색기(Win+E) 열기
  4. 윈도우가 제어하거나 모니터링하지 않는 폴더로 이동하거나 생성하세요(예: C:\MySpecialFolder)
  5. 상단의 '주소 표시줄'을 클릭하고 cmd를 입력한 후 Enter를 눌러 해당 폴더 내에서 명령 프롬프트를 엽니다.
  6. 검은 창(명령 프롬프트)이 나타나면 다음 중 하나를 입력하고 Enter를 누르세요:
  • 릴리스 브랜치: git clone https://github.com/SillyTavern/SillyTavern -b release
  • 스테이징 브랜치: git clone https://github.com/SillyTavern/SillyTavern -b staging
  1. 모든 것이 복제되면 Start.bat을 더블클릭하여 NodeJS가 요구 사항을 설치하도록 합니다.
  2. 서버가 시작되고 SillyTavern이 브라우저에서 열립니다.

GitHub Desktop을 통한 설치

(이 방법은 GitHub Desktop에서만 git 사용을 허용합니다. 명령줄에서도 git을 사용하려면 Git for Windows도 설치해야 합니다)

  1. NodeJS 설치(최신 LTS 버전 권장)
  2. GitHub Desktop 설치
  3. GitHub Desktop 설치 후 Clone a repository from the internet.... 클릭(참고: 이 단계에서는 GitHub 계정을 만들 필요가 없습니다)
  4. 메뉴에서 URL 탭을 클릭하고 이 URL https://github.com/SillyTavern/SillyTavern을 입력한 후 Clone을 클릭하세요. 로컬 경로를 변경하여 SillyTavern이 다운로드될 위치를 변경할 수 있습니다.
  5. SillyTavern을 열려면 Windows 탐색기에서 저장소가 복제된 폴더로 이동하세요. 기본적으로 저장소는 다음 위치에 복제됩니다: C:\Users\[윈도우 사용자 이름]\Documents\GitHub\SillyTavern
  6. start.bat 파일을 더블클릭하세요(참고: 파일 이름의 .bat 부분이 OS에 의해 숨겨져 있을 수 있으며, 이 경우 "Start"라는 파일로 보일 것입니다. 이것이 SillyTavern을 실행하기 위해 더블클릭하는 파일입니다)
  7. 더블클릭 후 큰 검은 명령 콘솔 창이 열리고 SillyTavern이 작동에 필요한 것을 설치하기 시작합니다.
  8. 설치 과정 후 모든 것이 정상적으로 작동하면 명령 콘솔 창은 다음과 같이 보일 것이며 브라우저에 SillyTavern 탭이 열립니다:
  9. 지원되는 API 중 하나에 연결하고 채팅을 시작하세요!

🐧 Linux & 🍎 MacOS

MacOS / Linux에서는 터미널에서 이 모든 작업을 수행합니다.

  1. git과 nodeJS 설치(OS에 따라 방법이 다름)
  2. 저장소 복제
  • 릴리스 브랜치: git clone https://github.com/SillyTavern/SillyTavern -b release
  • 스테이징 브랜치: git clone https://github.com/SillyTavern/SillyTavern -b staging
  1. cd SillyTavern으로 설치 폴더로 이동합니다.
  2. 다음 명령 중 하나로 start.sh 스크립트를 실행하세요:
  • ./start.sh
  • bash start.sh

🐋 Docker를 통한 설치

이 지침은 Docker가 설치되어 있고 컨테이너 설치를 위해 명령줄에 접근할 수 있으며 일반적인 작동에 익숙하다고 가정합니다.

GitHub Container Registry 사용

Docker Compose(가장 쉬움)

GitHub 저장소에서 docker-compose.yml 파일을 가져오고 파일이 있는 디렉토리에서 다음 명령을 실행하세요. 이렇게 하면 GitHub Container Registry에서 최신 릴리스 이미지를 가져와 컨테이너를 시작하고 필요한 볼륨을 자동으로 생성합니다.

docker-compose up

docker-compose.yml 파일을 필요에 따라 사용자 정의하세요. 기본 포트는 8000입니다. 환경 변수를 사용하여 서버 구성을 조정하려면 여기의 문서를 읽으세요.

Docker CLI(고급)

SillyTavern이 작동하려면 두 개의 필수 디렉토리 매핑과 포트 매핑이 필요합니다. 명령에서 다음 위치를 선택한 값으로 바꾸세요:

컨테이너 변수

볼륨 매핑
  • CONFIG_PATH - SillyTavern 구성 파일이 호스트 머신에 저장될 디렉토리
  • DATA_PATH - SillyTavern 사용자 데이터(캐릭터 포함)가 호스트 머신에 저장될 디렉토리
  • PLUGINS_PATH - (선택 사항) SillyTavern 서버 플러그인이 호스트 머신에 저장될 디렉토리
  • EXTENSIONS_PATH - (선택 사항) 전역 UI 확장이 호스트 머신에 저장될 디렉토리
포트 매핑
  • PUBLIC_PORT - 트래픽을 노출할 포트. 이는 필수 사항이며, 가상 머신 컨테이너 외부에서 인스턴스에 접근하기 위해 필요합니다. 보안을 위한 별도의 서비스를 구현하지 않고 인터넷에 노출하지 마세요.
추가 설정
  • SILLYTAVERN_VERSION - 이 GitHub 페이지 오른쪽에서 "Packages"를 볼 수 있습니다. "sillytavern" 패키지를 선택하면 이미지 버전을 볼 수 있습니다. "latest" 이미지 태그는 현재 릴리스와 최신 상태를 유지합니다. 해당 브랜치의 야간 빌드를 가리키는 "staging"도 사용할 수 있습니다.

컨테이너 실행

  1. 명령줄 열기
  2. 구성 및 데이터 파일을 저장할 폴더에서 다음 명령 실행:
SILLYTAVERN_VERSION="latest"
PUBLIC_PORT="8000"
CONFIG_PATH="./config"
DATA_PATH="./data"
PLUGINS_PATH="./plugins"
EXTENSIONS_PATH="./extensions"

docker run \
  --name="sillytavern" \
  -p "$PUBLIC_PORT:8000/tcp" \
  -v "$CONFIG_PATH:/home/node/app/config:rw" \
  -v "$DATA_PATH:/home/node/app/data:rw" \
  -v "$EXTENSIONS_PATH:/home/node/app/public/scripts/extensions/third-party:rw" \
  -v "$PLUGINS_PATH:/home/node/app/plugins:rw" \
  ghcr.io/sillytavern/sillytavern:"$SILLYTAVERN_VERSION"

기본적으로 컨테이너는 포그라운드에서 실행됩니다. 백그라운드에서 실행하려면 docker run 명령에 -d 플래그를 추가하세요.

이미지 직접 빌드

Windows, macOS 및 Linux에서 Docker를 사용한 SillyTavern 설치에 대한 포괄적인 가이드가 여기에 있습니다! 이미지를 직접 빌드하려면 읽어보세요.

⚡ SillyTavern Launcher를 통한 설치

SillyTavern Launcher는 로컬 추론을 위한 백엔드 설치를 포함한 많은 옵션으로 설정을 도와주는 설치 마법사입니다.

Windows 사용자를 위한

  1. 키보드에서 **WINDOWS + R**을 눌러 실행 대화 상자를 엽니다. 그런 다음 다음 명령을 실행하여 git을 설치하세요:
cmd /c winget install -e --id Git.Git
  1. 키보드에서 **WINDOWS + E**를 눌러 파일 탐색기를 열고, 런처를 설치할 폴더로 이동합니다. 원하는 폴더에 도달하면 주소 표시줄에 cmd를 입력하고 Enter를 누릅니다. 그런 다음 다음 명령을 실행하세요:
git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher && start installer.bat

Linux 사용자를 위한

  1. 선호하는 터미널을 열고 git 설치
  2. 다음 명령으로 Sillytavern-Launcher를 git clone:
git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
  1. installer.sh 시작:
chmod +x install.sh && ./install.sh
  1. 설치 후 launcher.sh 시작:
chmod +x launcher.sh && ./launcher.sh

Mac 사용자를 위한

  1. 터미널 열고 brew 설치:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. git 설치:
brew install git
  1. 다음 명령으로 Sillytavern-Launcher를 git clone:
git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
  1. installer.sh 시작:
chmod +x install.sh && ./install.sh
  1. 설치 후 launcher.sh 시작:
chmod +x launcher.sh && ./launcher.sh

📱 Android OS에서 Termux를 통한 설치

[!NOTE] SillyTavern은 Termux를 사용하여 Android 장치에서 기본적으로 실행할 수 있지만, 이 사용 사례에 대한 공식 지원을 제공하지 않습니다.

ArroganceComplex#2659의 이 가이드를 참조하세요:

지원되지 않는 플랫폼: android arm LEtime-web. 32비트 Android는 npm으로 설치할 수 없는 외부 종속성이 필요합니다. 다음 명령을 사용하여 설치하세요: pkg install esbuild. 그런 다음 일반적인 설치 단계를 실행하세요.

명령줄 인수

config.yaml의 일부 설정을 재정의하기 위해 SillyTavern 서버 시작 시 명령줄 인수를 전달할 수 있습니다.

예시

node server.js --port 8000 --listen false
# or
npm run start -- --port 8000 --listen false
# or (Windows only)
Start.bat --port 8000 --listen false

지원되는 인수

[!TIP] 어떤 인수도 필수 사항이 아닙니다. 제공하지 않으면 SillyTavern은 config.yaml의 설정을 사용합니다.

옵션설명타입
--version버전 번호 표시boolean
--configPathconfig.yaml 파일 경로 재정의string
--dataRoot데이터 저장 루트 디렉토리string
--portSillyTavern 실행 포트 설정number
--listen모든 네트워크 인터페이스에서 수신 대기boolean
--whitelist화이트리스트 모드 활성화boolean
--basicAuthMode기본 인증 활성화boolean
--enableIPv4IPv4 프로토콜 활성화boolean
--enableIPv6IPv6 프로토콜 활성화boolean
--listenAddressIPv4특정 IPv4 주소 지정string
--listenAddressIPv6특정 IPv6 주소 지정string
--dnsPreferIPv6DNS에 IPv6 우선 사용boolean
--sslSSL 활성화boolean
--certPath인증서 파일 경로string
--keyPath개인 키 파일 경로string
--autorun브라우저에서 SillyTavern 자동 실행boolean
--autorunHostname자동 실행 호스트네임string
--autorunPortOverride자동 실행 포트 재정의string
--avoidLocalhost자동 모드에서 'localhost' 사용 방지boolean
--corsProxyCORS 프록시 활성화boolean
--requestProxyEnabled외부 요청에 프록시 사용 활성화boolean
--requestProxyUrl요청 프록시 URL (HTTP 또는 SOCKS 프로토콜)string
--requestProxyBypass프록시 우회 목록 (호스트 공백 구분 목록)array
--disableCsrfCSRF 보호 비활성화 (권장하지 않음)boolean

원격 연결

주로 PC에서 ST 서버를 실행한 상태로 동일한 Wi-Fi 네트워크 상의 모바일 기기에서 SillyTavern을 사용하려는 사용자를 위한 기능입니다. 하지만 어디서든 원격 연결을 허용하는 데에도 사용할 수 있습니다.

자세한 원격 연결 설정 가이드는 문서에서 확인하세요.

또한 (선택적) 비밀번호 보호 기능이 있는 SillyTavern 사용자 프로필을 구성할 수도 있습니다: 사용자 관리.

라이선스 및 크레딧

이 프로그램은 유용하게 사용될 수 있도록 배포되지만, 어떠한 보증도 없이 제공됩니다. 상품성 또는 특정 목적에의 적합성에 대한 묵시적 보증을 포함하여 명시적이거나 묵시적인 어떤 보증도 하지 않습니다. 자세한 내용은 GNU Affero 일반 공중 라이선스를 참조하세요.

  • TavernAI 1.2.8 by Humi: MIT 라이선스
  • CncAnon의 TavernAITurbo 모드 일부 사용 허가 받음
  • Visual Novel 모드는 PepperTaco의 작업(https://github.com/peppertaco/Tavern/)에서 영감을 받음
  • Noto Sans 폰트 by Google (OFL 라이선스)
  • 아이콘 테마 by Font Awesome https://fontawesome.com (아이콘: CC BY 4.0, 폰트: SIL OFL 1.1, 코드: MIT 라이선스)
  • 기본 콘텐츠 by @OtisAlejandro (Seraphina 캐릭터 및 lorebook) 및 @kallmeflocc (10K Discord 사용자 기념 배경)
  • Docker 가이드 by @mrguymiah 및 @Bronya-Rand
  • kokoro-js 라이브러리 by @hexgrad (Apache-2.0 라이선스)

주요 기여자

Contributors