TauriTavern/README.pt-BR.md

TauriTavern

SillyTavern como aplicativo nativo para computadores e dispositivos móveis

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

Downloads · Documentação · Releases · Issues

_{Agradecemos a @shiyue137 por criar o logo do TauriTavern 💛}

Baixar

Detecta seu dispositivo automaticamente · baixe a versão estável mais recente com um clique

Todas as plataformas · Versões no GitHub

📦 Instalação com um gerenciador de pacotes (Windows · macOS · Linux)

Windows · WinGet

Execute no PowerShell:

winget install --id TauriTavern.TauriTavern

Windows · Scoop

Execute no PowerShell:

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

macOS · Homebrew

Execute no Terminal:

brew install --cask tauritavern

Linux

Arch Linux · AUR

Instale o tauritavern-bin com o AUR helper de sua preferência:

yay -S tauritavern-bin

Esse pacote é mantido por @LX2000WASD. Agradecemos pelo trabalho contínuo no TauriTavern-aur.

Debian · Ubuntu · Fedora · openSUSE · NixOS

O script identifica seu sistema e escolhe o método de instalação adequado. Ele também funciona em outros sistemas Linux que já tenham o Nix instalado.

Versão estável

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

Nix / NixOS

Se o Nix já estiver instalado, adicione o TauriTavern diretamente ao seu perfil de usuário:

nix profile add github:Darkatse/TauriTavern#tauritavern

Flatpak

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

Canary

A versão Canary recebe atualizações diárias com novos recursos e correções, mas pode ser menos estável que a versão estável. Se quiser testar a versão mais recente ou estiver enfrentando algum problema na versão estável, verifique se a correção já está disponível na Canary.

As compilações para Windows, macOS e dispositivos móveis estão disponíveis na página da Canary Release.

Instalar a Canary no Linux

Linux

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

Nix / NixOS

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

Tip

iOS: instale pelo teste público no TestFlight. É necessário ter o iOS 15.0 ou mais recente. O iOS 15.0–16.3 tem suporte limitado; o suporte completo começa no iOS 16.4. As compilações estão sujeitas às regras e limitações do TestFlight.

Versão portátil para Windows: requer o WebView2 Runtime instalado no sistema.

O que é o TauriTavern

O TauriTavern transforma o SillyTavern em um aplicativo nativo. O frontend mantém a experiência do projeto original e está sincronizado com a versão 1.19.0, enquanto o backend foi reescrito de Node.js para Rust com Tauri v2.

Não é preciso instalar o Node.js nem usar a linha de comando: basta baixar e executar. Seus cartões de personagem, chats, predefinições, Informações do Mundo e extensões de frontend continuam compatíveis com o SillyTavern.

Observação: o TauriTavern é um projeto independente de código aberto, não um cliente oficial do SillyTavern. Ele é gratuito e distribuído sob a licença AGPL-3.0. Consulte os termos da licença antes de usar.

Principais recursos

• 🖥️ Cinco plataformas nativas: Windows, macOS, Linux, Android e iOS com a mesma experiência de uso
• 🎭 Compatibilidade com o SillyTavern: o frontend está sincronizado com a versão 1.19.0, incluindo formatos de dados e estrutura de diretórios compatíveis
• 🧩 Ecossistema de extensões do frontend: o Git nativo integrado permite instalar, atualizar e trocar de branch pela própria interface (plugins de backend exclusivos para Node.js não são compatíveis)
• 🔄 Sincronização entre dispositivos: pareamento criptografado pela rede local ou envio automático pelo TT-Sync v2 remoto
• 🤖 Agent Framework: chamadas de ferramentas, Skills, subagentes e linha do tempo de execução; o desenvolvimento continua
• 📦 Migração direta: scripts de exportação do SillyTavern e importação dentro do aplicativo
• ⚡ Otimizações de desempenho: inicialização em etapas e virtualização do DOM do chat mantêm a interface fluida mesmo em conversas muito longas
• 🔒 Seus dados permanecem com você: tudo fica armazenado no dispositivo, com um modo portátil opcional

Capturas de tela

Visão geral da arquitetura

O backend em Rust é organizado como um workspace Cargo (src-tauri/crates/) baseado em Clean Architecture:

• tauritavern: host Tauri, camada de comandos e raiz de composição
• tt-application · tt-ports · tt-domain · tt-contracts: casos de uso, portas, modelos de domínio e contratos entre crates
• tt-adapter-*: implementações de armazenamento, HTTP, mídia, sincronização, extensões e tokenização

O frontend combina o SillyTavern original com uma camada modular de integração com o Tauri (src/tauri/main/). Ele se comunica com o backend em Rust pela ABI de plataforma window.__TAURITAVERN__. Consulte docs/BackendStructure.md e docs/FrontendGuide.md para saber mais.

🛠 Desenvolvimento (pré-requisitos · comandos comuns · Tauri Pilot · builds portáteis · FasTools)

Pré-requisitos: Rust stable (edition 2024) · Node.js 22.13+ · pnpm 11 · Tauri CLI

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

Comandos comuns:

pnpm run check         # verificações de frontend, tipos, contratos e código Rust
pnpm run web:build     # gera os bundles do frontend com Rspack
pnpm run tauri:dev     # modo de desenvolvimento para desktop
pnpm run tauri:build   # compila os instaladores para desktop
pnpm run android:dev   # modo de desenvolvimento para Android
pnpm run ios:dev       # modo de desenvolvimento para iOS

Tauri Pilot (desenvolvimento de frontend com agentes de IA)

O projeto inclui o plugin Tauri Pilot e suas permissões somente para desenvolvimento. Com ele, um agente de IA pode inspecionar e operar o WebView no desktop, no Android e no Simulador do iOS por meio de snapshots de acessibilidade. Os comandos normais de desenvolvimento e as compilações de lançamento não ativam esse recurso.

cargo install tauri-pilot-cli  # necessário apenas uma vez
pnpm run tauri:dev:pilot       # desktop
pnpm run android:dev:pilot     # Android; encaminhe o socket antes, veja docs/AndroidDevelopment.md
pnpm run ios:dev:pilot         # Simulador do iOS

Depois de iniciar o aplicativo, use outro terminal para executar o fluxo básico:

tauri-pilot ping
tauri-pilot snapshot -i
tauri-pilot click @e3          # use um ref do snapshot atual
tauri-pilot diff -i
tauri-pilot logs --level error

Tire um snapshot antes de interagir e execute uma ação por vez. Use wait após atualizações assíncronas e prefira assert para verificar o resultado. Um agente compatível com MCP pode registrar tauri-pilot mcp como servidor stdio.

Builds portáteis: pnpm run tauri:build:portable (gera os arquivos em release/). Para forçar o modo portátil, use TAURITAVERN_RUNTIME_MODE=portable ou crie um arquivo portable.flag.

FasTools: conjunto recomendado de ferramentas para desenvolvimento e diagnóstico de distribuição. Compile com pnpm run fastools:build e execute com pnpm run fastools:run.

Os detalhes de cada plataforma estão em docs/AndroidDevelopment.md e docs/iOSDevelopment.md.

Documentação

• 📖 Documentação on-line: guias em chinês e inglês sobre uso, Agent, arquitetura, API e downloads
• docs/FrontendGuide.md: arquitetura do frontend e guia de extensões
• docs/FrontendHostContract.md: contrato público da camada de host
• docs/BackendStructure.md: Clean Architecture do backend e limites entre crates
• docs/CurrentState/: estado atual dos módulos implementados

Como contribuir

Issues e Pull Requests são bem-vindos. Leia primeiro o CONTRIBUTING.md e, exceto em correções urgentes, use a branch dev como destino.

Agradecimentos e licença

O projeto foi criado a partir do SillyTavern e do Tauri. Agradecemos aos responsáveis por Cocktail, Tavern-Helper, LittleWhiteBox, MikTik e a @LX2000WASD, que mantém o pacote do TauriTavern para AUR.

Distribuído sob a licença AGPL-3.0, da mesma família de licenças usada pelo SillyTavern.

_{Feito com cuidado pela equipe do TauriTavern ❤️}