Darkatse/TauriTavern

TauriTavern – SillyTavern을 위한 네이티브 데스크톱 & 모바일 클라이언트

개요 – TauriTavern은 SillyTavern 웹 UI(채팅 기반 AI 에이전트를 위한 인기 프론트엔드)를 Tauri v2 애플리케이션 내에 번들로 포함합니다. 기존 프로젝트의 Node.js 백엔드가 Rust로 재작성되어, 전체 스택이 진정한 네이티브 프로그램으로 실행됩니다. Node 런타임나 명령줄 설정 없이 설치 후 바로 실행할 수 있습니다.

중요성 – SillyTavern의 모든 기능(캐릭터 카드, 채팅 기록, 월드북, 확장 프로그램)을 유지하면서 다음과 같은 이점을 얻을 수 있습니다:

Windows, macOS, Linux, Android 및 iOS를 위한 크로스 플랫폼 네이티브 바이너리.
완전한 개인정보 보호를 위한 로컬 전용 데이터 저장(또는 포터블 모드).
내장된 Git 스타일의 확장 프로그램 관리자와 기기 간 데이터 이동을 위한 LAN 암호화 동기화 시스템(TT-Sync v2).
선택 사항인 Tauri Pilot 디버깅 플러그인을 통해 노출되는 도구 호출, 스킬 및 서브 에이전트를 지원하는 에이전트 프레임워크.

주요 기능 (README 목록 기준)

풀 플랫폼 네이티브 앱 – 하나의 코드베이스로 데스크톱과 모바일에서 실행.
정확한 SillyTavern UI 호환성 – 업스트림 v1.18.0와 동기화된 프론트엔드, 동일한 파일 레이아웃.
네이티브 확장 프로그램 생태계 – UI에서 확장 프로그램 설치, 업데이트 및 브랜치 전환 가능 (Node 전용 플러그인은 지원되지 않음).
멀티 디바이스 동기화 – LAN 암호화 페어링 또는 클라우드 기반 TT-Sync v2.
에이전트 프레임워크 – 도구 호출, 스킬, 자식 에이전트, 런타임 타임라인 (현재 개발 중).
원클릭 마이그레이션 – SillyTavern용 내보내기 스크립트 + 앱 내 가져오기.
성능 엔지니어링 – 단계별 시작 및 가상 DOM 채팅 렌더링으로 긴 대화 기록도 부드럽게 유지.
데이터 자율성 – 모든 데이터는 로컬에 저장; 포터블 모드는 설치 없이 작동.

지원 플랫폼

플랫폼	설치 방법
Windows	설치 프로그램, Scoop bucket, 포터블 zip (WebView2 필요)
macOS	Homebrew Cask
Linux	AUR (`tauritavern-bin`), 스크립트 (`install-linux.sh`), Nix, Flatpak
Android	다운로드 페이지의 직접 APK
iOS	TestFlight (iOS 16+)

빠른 설치 (stable 채널)

# Linux (모든 배포판)
curl -fsSL https://raw.githubusercontent.com/Darkatse/TauriTavern/main/scripts/install-linux.sh | sh

# macOS (Homebrew 사용)
brew install --cask tauritavern

# Windows (Scoop 사용)
scoop bucket add Darkatse https://github.com/Darkatse/Scoop-Darkatse.git
scoop install Darkatse/TauriTavern

최신 기능을 원하는 사용자를 위해 Canary 빌드(데일리)를 사용할 수 있습니다. 설치 방법은 동일하지만 --channel canary 플래그를 사용합니다.

아키텍처 개요

Rust 백엔드 – 클린 아키텍처 Cargo 워크스페이스 (src-tauri/crates/)로 구성되며 다음과 같이 나뉩니다:
- tauritavern – Tauri 호스트 및 커맨드 레이어
- tt-application, tt-ports, tt-domain, tt-contracts – 유스케이스, 포트, 도메인 모델, 크로스 크레이트 계약
- tt-adapter-* – 저장소, HTTP, 미디어, 동기화, 확장 프로그램, 토큰화 등을 위한 구체적인 어댑터
프론트엔드 – 업스트림 SillyTavern UI에 Tauri 주입 레이어 (src/tauri/main/)가 추가됨. 통신은 글로벌 window.__TAURITAVERN__ ABI를 통해 이루어집니다.
선택적 도구 – Tauri Pilot 플러그인은 AI 에이전트가 접근성 스냅샷을 통해 UI를 제어할 수 있게 합니다 (에이전트 디버깅용이며 일반 릴리스에는 활성화되지 않음).

개발 시작하기

git clone https://github.com/Darkatse/TauriTavern.git
cd TauriTavern
pnpm install          # JS 의존성 및 Tauri CLI 설치
pnpm run tauri:dev    # 데스크톱 개발 모드 실행
pnpm run tauri:build  # 릴리스 바이너리 생성

Android/iOS 개발, 포터블 빌드 및 FasTools 툴박스를 위한 추가 스크립트가 존재합니다.

라이선스 및 커뮤니티

라이선스: AGPL-3.0 (SillyTavern과 동일). 코드는 완전히 오픈 소스입니다.
커뮤니티: Telegram 그룹, Discord 서버, GitHub 이슈 및 contrib.rocks를 통해 표시되는 기여자 목록.
기여: CONTRIBUTING.md를 따르십시오. 긴급한 수정이 아닌 경우 PR 대상은 dev 브랜치입니다.

요약

TauriTavern은 AI 애호가들에게 SillyTavern 채팅 플랫폼을 위한 네이티브하고 개인정보를 우선시하는 클라이언트를 제공합니다. 멀티 디바이스 동기화, 발전 중인 에이전트 프레임워크, 그리고 모든 주요 데스크톱 또는 모바일 OS에 대해 확장하거나 컴파일할 수 있는 현대적인 Rust/Tauri 코드베이스를 갖추고 있습니다.