Tavern Studio Download
Tavern Studio SEO Article - KO

SillyTavern에서 Tavern Studio로 마이그레이션하는 방법

Tavern Studio에는 SillyTavern에서의 마이그레이션 프로세스를 용이하게 해주는 전용 마이그레이션 도구가 내장되어 있습니다. 캐릭터 카드, 로어북(Lorebook), 프리셋, API 설정 및 대화 기록 파일을 일일이 수동으로 내보내거나 복사할 필요가 없습니다. Tavern Studio에서 SillyTavern 프로젝트 폴더를 지정한 다음, 가져오기 미리보기를 확인하고 원하는 콘텐츠를 선택해 이전할 수 있습니다.

이 마이그레이션 프로세스는 SillyTavern의 원본 파일에 대해 읽기 전용(Read-only)으로 동작합니다. Tavern Studio는 원본 폴더에서 데이터를 읽어 자체 독립 작업 공간(Workspace), 데이터베이스 및 리소스 관리 시스템에 복사본을 저장합니다. 따라서 SillyTavern의 원본 폴더 내 파일은 삭제, 이동 또는 수정되지 않고 보존됩니다.

이 가이드는 캐릭터 카드, 월드 정보(World Info) 및 로어북 설정, OpenAI 호환 프리셋(Presets), API 키 및 설정 구성, 그리고 표준 JSONL 대화 기록의 이전 방법을 소개합니다.

대상 독자

  • 기존 SillyTavern에서 Tavern Studio로 이전을 준비 중인 사용자.
  • 캐릭터 카드, 로어북, 프리셋 및 대화 기록을 보유하고 있는 사용자.
  • 로컬 창작 자산을 보존하면서 네이티브 데스크톱 클라이언트의 쾌적함을 원하는 사용자.
  • 마이그레이션 실행 전 미리보기를 통해 대상 데이터 수량을 확인하고 싶은 사용자.
  • 원본 SillyTavern 폴더를 그대로 유지하고 싶은 사용자.

주요 마이그레이션 대상 데이터

내장된 마이그레이션 도구는 SillyTavern의 아래 데이터를 지원합니다.

  • 캐릭터 카드(Character Cards): 로컬에 저장된 캐릭터 카드.
  • 월드 정보 및 로어북(World Info / Lorebooks): 세계관 설정 및 배경 지식 데이터.
  • OpenAI 호환 프리셋(OpenAI-compatible presets): 사용자 정의 시스템 프롬프트 및 파라미터 구성.
  • API 키 및 설정(API keys/configs): API 제공업체의 연결 설정 및 인증키.
  • 표준 JSONL 대화 기록(standard JSONL chats): 캐릭터별 대화 기록 로그.

API 설정을 가져올 때 Tavern Studio는 가급적 표준 OpenAI 호환 인터페이스 설정을 자동으로 매핑합니다. OpenAI, Groq, Mistral, Perplexity, Cohere, xAI 등 많이 쓰이는 호환 공급업체는 기본값과 함께 자동 적용됩니다.

하지만 일부 고급 설정이나 특정 환경 구성은 마이그레이션 후 점검이 필요합니다. 아래 항목은 이전을 완료한 뒤 수동으로 정보를 보완해야 합니다.

  • 사용자 정의 API 엔드포인트(Custom endpoints) 및 로컬 LLM 서비스(예: LM Studio, Ollama).
  • 역방향 프록시(Reverse proxies) 및 사용자 정의 프록시 주소.
  • Azure OpenAI 및 Cloudflare Workers AI 연동 설정.
  • 공급업체 계정 ID, 누락된 Base URL, 혹은 기본 모델 재선택 사항.

주의: 그룹 채팅(Group chats)의 마이그레이션은 현재 완전히 지원되지 않습니다. 마이그레이션 후에 손상되거나 관리가 불가능한 대화창이 생성되는 것을 방지하기 위해, 지원되지 않는 일부 그룹 채팅 데이터는 자동으로 건너뛸 수 있습니다.

Tavern Studio의 데이터 마이그레이션 방식

Tavern Studio는 마이그레이션을 애플리케이션 수준의 데이터 관리 작업으로 다룹니다. 개별 파일을 가져오기 창에 일일이 드래그 앤 드롭할 필요 없이, 지정된 SillyTavern 프로젝트 폴더를 검사하여 요약 미리보기를 구성합니다. 사용자는 사용자 계정별 또는 데이터 종류별로 범위를 필터링한 후 가져오기를 진행하게 됩니다.

가져오기가 완료되면 Tavern Studio는 데이터를 리로드하여 새로 마이그레이션된 캐릭터, 로어북, 대화 내용 및 API 설정이 정상 위치에 보이도록 합니다. 만약 가져온 자산(프로필 이미지, 배경, 로어북 등)이 즉시 확인되지 않는 경우, 애플리케이션을 재시작하거나 해당 페이지를 새로고침하면 최신 데이터베이스 정보를 읽어옵니다.

작업 절차

1단계: SillyTavern 프로젝트 루트 폴더 찾기

SillyTavern이 설치된 루트 폴더 경로를 확인합니다. 이 폴더 내부에는 설정과 자산들이 저장되어 있는 data 디렉터리가 포함되어 있어야 합니다.

예를 들어, Windows 환경에서는 다음과 같은 경로 형태를 가집니다.

C:\code\SillyTavern\SillyTavern

이 경로 내에 data 하위 폴더가 존재하는지 다시 한번 확인합니다.

C:\code\SillyTavern\SillyTavern\data

주의: 실수로 data 폴더 자체를 선택한 경우 Tavern Studio가 자동으로 상위 경로로 교정하려고 시도하지만, 처음부터 data 폴더가 포함되어 있는 프로젝트의 루트 폴더를 지정하는 것을 권장합니다.

2단계: Tavern Studio에서 가져오기 도구 열기

Tavern Studio를 실행하고 다음 메뉴로 이동합니다.

Settings -> Data Management -> Import from SillyTavern

Choose Folder 버튼을 클릭하고 앞서 확인한 SillyTavern 프로젝트 루트 폴더를 지정합니다.

3단계: 가져오기 미리보기 확인

가져오기 도구가 폴더를 스캔하는 동안 잠시 기다려 주십시오. 스캔이 완료되면 다음 데이터들의 수량이 요약되어 표시됩니다.

  • 캐릭터 카드
  • 월드 정보 / 로어북
  • 프리셋
  • API 구성
  • 대화 로그

미리보기 결과가 비어 있거나 개수가 예상과 크게 다를 경우, 프로세스를 중단하고 올바른 SillyTavern 프로젝트 루트 폴더를 지정했는지 다시 확인해 보십시오.

4단계: 사용자 및 데이터 범위 선택

가져오기를 진행할 특정 SillyTavern 사용자 데이터와 데이터 그룹을 선택합니다. 보관하고 있는 자산이 많다면, 먼저 핵심 캐릭터 카드 위주로 가져와 검증 단계를 거치면 편리합니다.

5단계: 가져오기 실행

Import를 클릭하고 처리가 완료될 때까지 대기합니다. 성공적으로 끝나면 Tavern Studio가 데이터베이스와 활성 작업 공간을 자동으로 리로드합니다.

6단계: 이전된 자산 확인

이전 완료 후 아래의 공간에서 작동하는지 검사합니다.

  • Characters: 메인 캐릭터 목록에 카드들이 잘 들어왔는지 확인합니다.
  • Chats: 가져온 캐릭터와 나눴던 대화창을 열어 JSONL 히스토리가 잘 불러와졌는지 봅니다.
  • World Books: 로어북 관리 화면에서 가져온 세계관 설정 정보들을 확인합니다.
  • API Settings: API 구성 메뉴에서 설정했던 인증 키와 엔드포인트 매핑 상태를 검사합니다.
  • Resource Assets: 아바타 이미지, 배경 및 연결된 미디어 파일들이 잘 나타나는지 봅니다.

7단계: API 엔드포인트 및 모델 설정 유효성 검사

이전된 API 구성 설정에 대해 다음을 점검해 주십시오.

  • API 키가 저장되어 있는지.
  • Base URL이 API 제공업체의 현재 엔드포인트 주소와 일치하는지.
  • 선택된 기본 모델이 유효하고 지원 대상인지.
  • 프록시 주소, 계정 ID, 혹은 로컬 호스트 호스트네임 등의 필요한 수동 입력란이 누락되지 않았는지.

모든 세팅이 끝났다면 마이그레이션된 캐릭터와 프리셋을 활용해 간단한 테스트 메시지를 발송해 정상 작동 여부를 먼저 확인한 뒤 채팅 세션을 즐기시는 것을 추천합니다.

SillyTavern과의 관계

Tavern Studio는 SillyTavern의 공식 릴리스가 아닌, 별도로 개발된 독립적인 대안 프로그램입니다. 표준 커뮤니티 AI 캐릭터 카드 포맷을 지원하는 독립형 로컬 중심 애플리케이션입니다. 이 가져오기 기능은 기존에 쌓아 올린 창작 자산과 유용한 파라미터 설정을 활용할 수 있도록 돕는 유틸리티일 뿐이며, 원본 SillyTavern 프로그램의 동작이나 파일에 영향을 끼치지 않습니다.

자주 묻는 질문 (FAQ)

마이그레이션 시 어떤 폴더를 선택해야 합니까?

SillyTavern의 프로젝트 루트 디렉터리(data 폴더가 들어있는 폴더, 예: C:\code\SillyTavern\SillyTavern)를 선택하셔야 합니다. 개별 캐릭터 폴더나 data 폴더 자체를 선택하지 마십시오.

가져오기 작업을 수행하면 SillyTavern 원본 파일이 변경되나요?

아닙니다. 가져오기 도구는 읽기 전용으로 작동합니다. SillyTavern 경로에서 파일만 읽은 뒤 복사본을 Tavern Studio의 독립된 데이터베이스와 공간에 작성하므로, 원래의 파일들은 전혀 변하지 않습니다.

어떤 데이터들을 지원하나요?

캐릭터 카드, 월드 정보 / 로어북, OpenAI 호환 프리셋, API 키/연동 설정 구성, 그리고 표준 JSONL 규격의 대화 로그를 이전할 수 있습니다.

대화 내역도 마이그레이션 되나요?

네, 캐릭터에 귀속되어 있던 표준 JSONL 포맷 대화 내역을 가져올 수 있습니다. 각각의 대화 로그 파일은 고유한 대화 스레드로 변환되어 메시지 순서가 유지됩니다. 단, 포맷이 깨지거나 지원되지 않는 대화 파일은 누락될 수 있습니다.

그룹 채팅 가져오기도 지원되나요?

그룹 채팅은 아직 완전히 지원되지 않는 기능입니다. 가져오기 도중 깨지거나 관리가 되지 않는 대화 기록이 생기지 않도록 일부 그룹 채팅 정보는 건너뛰도록 설정되어 있습니다.

특정 로컬 서버나 프록시 세팅이 가져오기 후 수동 입력을 요구하는 이유는 무엇인가요?

사용자 정의 엔드포인트, 로컬 서버(Ollama, LM Studio 등), Azure OpenAI, Cloudflare Workers AI, 그리고 역방향 프록시 세팅 등은 도메인 구성이나 계정 정보, 또는 특수 라우팅 경로를 수반하므로 자동 이전이 힘듭니다. 이들은 API 설정 메뉴에서 별도로 수동 기재를 완료해 주어야 정상 구동됩니다.

가져온 자산들이나 캐릭터들이 목록에 나타나지 않으면 어떻게 해야 합니까?

먼저 가져오기 완료 로그에 문제가 없는지 살펴봅니다. 파일은 정상 이전되었으나 목록에 즉시 뜨지 않는 경우, 페이지를 새로고침하거나 Tavern Studio 앱을 완전히 껐다가 켜서 리소스 데이터베이스를 동기화해 주십시오.

이전을 시작하기 전에 SillyTavern 폴더를 백업해야 하나요?

가져오기 도구는 안전한 읽기 전용 모드로 동작하여 SillyTavern 폴더를 건드리지 않지만, 데이터 이전을 수행할 때에는 예기치 못한 물리 장치 결함 등에 대비하여 원본 데이터를 따로 백업해두는 것을 권장합니다.

다음 단계