TauriTavern

SillyTavern, as a native app — desktop & mobile, out of the box

简体中文 · English · 日本語 · Русский · Português (Brasil)

Downloads · Docs · Releases · Issues

_{Thanks to @shiyue137 for designing the TauriTavern logo 💛}

Download

winget install --id TauriTavern.TauriTavern

scoop bucket add Darkatse https://github.com/Darkatse/Scoop-Darkatse.git
scoop install Darkatse/TauriTavern

brew install --cask tauritavern

yay -S tauritavern-bin

curl -fsSL https://get.tauritavern.com/linux.sh | sh

nix profile add github:Darkatse/TauriTavern#tauritavern

flatpak remote-add --user --if-not-exists \
  tauritavern \
  https://flatpak.tauritavern.com/tauritavern.flatpakrepo
flatpak install --user tauritavern com.tauritavern.client

Canary

Canary receives daily updates with new features and fixes, but may be less reliable than Stable. If you want to try the latest build or are having an issue with Stable, check whether Canary already includes a fix.

Windows, macOS, and mobile builds are available from the Canary Release.

curl -fsSL https://get.tauritavern.com/linux.sh \
  | sh -s -- --channel canary

nix profile add github:Darkatse/TauriTavern/Canary#canary

[!TIP] iOS: install via the public TestFlight beta. It requires iOS 15.0 or later. iOS 15.0–16.3 receives limited support; full support starts with iOS 16.4. TestFlight builds are subject to Apple's TestFlight rules and have usage restrictions.

Windows portable: requires the WebView2 runtime on the system.

HarmonyOS (beta): the HAP in Releases is for HarmonyOS NEXT. Sign it with your own certificate to install it; we recommend Auto-Installer. It has only been tested on the emulator so far.

What is TauriTavern

TauriTavern ports SillyTavern into a true native app: the frontend keeps the full upstream experience (synced to 1.19.0), while the backend is rebuilt from Node.js into Rust (Tauri v2).

No Node.js to install, no command line — just download and run. Your character cards, chats, presets, world info, and frontend extensions all stay compatible with SillyTavern.

Note: TauriTavern is an independently maintained open-source project, not an official SillyTavern client. TauriTavern is free and open source under the AGPL-3.0 license. Please review the license terms before use.

Highlights

• 🖥️ Five native platforms: Windows, macOS, Linux, Android, and iOS — one experience everywhere; native HarmonyOS support is currently in beta
• 🎭 Full SillyTavern experience: frontend synced to upstream 1.19.0, with fully compatible data formats and directory layout
• 🧩 Frontend extension ecosystem: built-in native Git — install, update, and switch branches right in the UI (Node-only backend plugins are not supported)
• 🔄 Built-in multi-device sync: encrypted LAN pairing, or automatic upload via the remote TT-Sync v2
• 🤖 Agent framework: tool calling, Skills, sub-agents, and a run timeline; development is ongoing
• 📦 One-click migration: SillyTavern export scripts + in-app import for a smooth move
• ⚡ Performance engineering: phased startup and chat DOM virtualization keep even very long chats smooth
• 🔒 Your data, yours: everything stays on your device, with an optional portable mode

Screenshots

Architecture at a Glance

The Rust backend is a Clean Architecture Cargo workspace (src-tauri/crates/):

• tauritavern: Tauri host, command layer, and composition root
• tt-application · tt-ports · tt-domain · tt-contracts: use cases, ports, domain models, and cross-crate contracts
• tt-adapter-*: concrete storage, HTTP, media, sync, extension, and tokenization implementations

The frontend is upstream SillyTavern plus a modular Tauri injection layer (src/tauri/main/), talking to the Rust backend through the window.__TAURITAVERN__ platform ABI. See docs/BackendStructure.md and docs/FrontendGuide.md for details.

git clone https://github.com/Darkatse/TauriTavern.git
cd TauriTavern
pnpm install

pnpm run check         # frontend guardrails/types/contracts + Rust dev check
pnpm run web:build     # build frontend bundles (Rspack)
pnpm run tauri:dev     # desktop dev mode
pnpm run tauri:build   # build desktop installers
pnpm run android:dev   # Android dev mode
pnpm run ios:dev       # iOS dev mode

cargo install tauri-pilot-cli  # only needed once
pnpm run tauri:dev:pilot       # desktop
pnpm run android:dev:pilot     # Android; forward the socket first, see docs/AndroidDevelopment.md
pnpm run ios:dev:pilot         # iOS Simulator

tauri-pilot ping
tauri-pilot snapshot -i
tauri-pilot click @e3          # use a ref from the current snapshot
tauri-pilot diff -i
tauri-pilot logs --level error

Documentation

• 📖 Online docs: bilingual guides covering usage, Agent, architecture, API, and downloads
• docs/FrontendGuide.md: frontend architecture and extension guide
• docs/FrontendHostContract.md: public host-layer contract
• docs/BackendStructure.md: backend Clean Architecture and crate boundaries
• docs/CurrentState/: implementation status of shipped modules

Contributing

Issues and PRs are welcome! Please read CONTRIBUTING.md first, target the dev branch unless it is an urgent fix.

Acknowledgements & License

Built on SillyTavern and Tauri, with thanks to Cocktail, Tavern-Helper, LittleWhiteBox, MikTik, @LX2000WASD for maintaining the TauriTavern AUR package, and @LeenHawk for the HarmonyOS port.

Released under AGPL-3.0 (same license family as SillyTavern).

_{Made with love and care ❤️ — The TauriTavern Team}