Tavern Studio Download
Tavern Studio SEO Article - PT

Como migrar do SillyTavern para o Tavern Studio

O Tavern Studio inclui um utilitário de migração integrado para o SillyTavern, desenvolvido para facilitar a sua transição. Você não precisa exportar ou copiar manualmente cada cartão de personagem, Lorebook, preset, configuração de API ou arquivo de chat de forma individual. Em vez disso, basta apontar o Tavern Studio para a pasta do projeto do SillyTavern, conferir a visualização prévia da importação, escolher os conteúdos que deseja transferir e executar o processo de importação.

O processo de migração funciona em modo de apenas leitura para os seus arquivos do SillyTavern. O Tavern Studio lê os recursos do diretório de origem e grava cópias importadas em seu próprio espaço de trabalho (workspace), banco de dados e sistema de gerenciamento de recursos. A sua pasta original do SillyTavern permanece inalterada durante esta importação segura de apenas leitura — nenhum arquivo é deletado, movido ou modificado.

Este guia foca no fluxo de migração para transferir cartões de personagem, World Info / Lorebooks, presets compatíveis com OpenAI, chaves e configurações de API, além de históricos de chat no formato JSONL padrão.

Para quem serve este guia?

  • Usuários ativos do SillyTavern que estão migrando para o Tavern Studio.
  • Usuários com coleções de cartões de personagem, Lorebooks, presets e históricos de conversas.
  • Usuários que buscam um cliente desktop nativo, mas querem preservar seus ativos criativos existentes.
  • Usuários que preferem verificar o resultado da importação em um resumo antes de confirmar a migração.
  • Usuários que desejam garantir a integridade de sua pasta original do SillyTavern.

Conteúdo Principal

O fluxo de migração integrado oferece suporte aos seguintes tipos de dados do SillyTavern:

  • Cartões de Personagem (Character Cards): Cartões de personagem armazenados localmente.
  • World Info / Lorebooks: Configurações de mundo e informações de contexto.
  • Presets compatíveis com OpenAI: Prompts de sistema personalizados e configurações de geração.
  • Chaves & Configurações de API: Chaves de acesso e parametrizações de provedores.
  • Históricos de Chat em JSONL padrão: Registros de chats individuais vinculados aos personagens.

Ao importar configurações de API, o Tavern Studio mapeia configurações padrão compatíveis com OpenAI sempre que possível. Provedores populares como OpenAI, Groq, Mistral, Perplexity, Cohere e xAI são convertidos com valores padrão.

Contudo, certas configurações de API necessitam de ajuste manual pós-migração. Você precisará preencher manualmente:

  • Endpoints de API personalizados e servidores locais de LLM (por exemplo, LM Studio, Ollama).
  • Proxies reversos e caminhos de proxy customizados.
  • Integrações com o Azure OpenAI e Cloudflare Workers AI.
  • Identificadores de conta (account IDs) de provedores, URLs base ausentes ou seleção do modelo padrão.

Nota: A migração de chats em grupo (group chats) ainda não é totalmente suportada. O Tavern Studio poderá ignorar dados de chats em grupo incompatíveis para evitar a criação de históricos corrompidos ou difíceis de gerenciar.

Como o Tavern Studio resolve esse problema

O Tavern Studio gerencia a migração a partir do SillyTavern como uma tarefa de gerenciamento de dados no nível do aplicativo. Em vez de exigir que você arraste e solte arquivos individuais em importadores separados, o importador integrado varre a pasta raiz do projeto do SillyTavern, monta uma prévia, permite filtrar por usuário ou categoria de dados, e efetua a importação para o espaço de trabalho do Tavern Studio.

Uma vez concluída a importação, o Tavern Studio atualiza os dados do aplicativo para que os personagens, Lorebooks, chats e configurações de API fiquem visíveis nos respectivos painéis. Se algum recurso importado recentemente (como avatares, imagens de fundo ou Lorebooks) não aparecer imediatamente, reiniciar o aplicativo ou atualizar a página correspondente forçará uma nova leitura da base de recursos.

Passos Operacionais

Passo 1: Localize a pasta raiz do seu projeto SillyTavern

Identifique a pasta raiz de instalação do seu SillyTavern. Esse diretório precisa conter a subpasta data onde o SillyTavern armazena as configurações e os ativos de mídia.

Por exemplo, no Windows, o caminho costuma ser:

C:\code\SillyTavern\SillyTavern

Dentro dessa pasta raiz, verifique se a subpasta data está presente:

C:\code\SillyTavern\SillyTavern\data

Nota: Se selecionar a pasta data por engano, o Tavern Studio tentará reajustar o caminho de forma automática, mas recomendamos escolher diretamente o diretório raiz que contém a pasta data.

Passo 2: Abra o importador no Tavern Studio

Inicie o Tavern Studio e acesse:

Settings -> Data Management -> Import from SillyTavern

Clique em Choose Folder e selecione o diretório raiz do projeto SillyTavern.

Passo 3: Analise a prévia de importação

Aguarde o importador concluir a varredura da pasta. A tela exibirá um resumo informando a quantidade de:

  • Personagens
  • World Books / Lorebooks
  • Presets
  • Configurações de API
  • Registros de chat

Se a prévia estiver vazia ou com contagens incorretas, cancele a operação e confirme se a pasta selecionada é de fato a raiz do SillyTavern.

Passo 4: Selecione os usuários e o escopo dos dados

Marque os dados de usuário do SillyTavern e os grupos de conteúdo que deseja importar. Se possuir um grande volume de informações, sugerimos migrar primeiro os cartões de personagem principais para simplificar a conferência.

Passo 5: Execute a importação

Clique em Import e aguarde o término do processo. Ao finalizar, o Tavern Studio recarregará automaticamente o banco de dados e a área de trabalho ativa.

Passo 6: Verifique os recursos importados

Após a importação, verifique os seguintes locais no Tavern Studio:

  • Characters: Abra a lista de personagens para conferir se os cartões aparecem nela.
  • Chats: Abra o chat dos personagens importados e verifique se o histórico em JSONL foi carregado corretamente.
  • World Books: Vá para a área de Lorebooks para conferir os arquivos de World Info migrados.
  • API Settings: Verifique as chaves e mapeamentos de conexão na aba de API.
  • Resource Assets: Confirme se os avatares, fundos e mídias associadas estão visíveis.

Passo 7: Confirme endpoints e parametrizações de API

Para todas as configurações de API importadas, valide:

  • Se a chave de API correspondente foi gravada corretamente.
  • Se a URL base está apontando para o endpoint ativo do provedor.
  • Se o modelo padrão indicado é válido e compatível.
  • Se há necessidade de preencher manualmente proxies, IDs de conta ou caminhos de servidores locais.

Envie uma mensagem rápida de teste utilizando um personagem e preset importados para garantir que a conexão funciona antes de iniciar uma conversa longa.

Relação com o SillyTavern

O Tavern Studio é uma alternativa independente e não possui vínculo com o projeto oficial do SillyTavern. Trata-se de um aplicativo separado, com foco local (local-first), projetado para aceitar formatos padrão de cartões de personagem e dados de mundo da comunidade. O importador é oferecido como um utilitário de conveniência para ajudar na reutilização dos seus recursos, sem alterar ou interferir na instalação original do SillyTavern.

Perguntas Frequentes

Qual pasta devo selecionar no importador?

Você deve selecionar a pasta raiz do SillyTavern — aquela que contém o diretório chamado data (por exemplo, C:\code\SillyTavern\SillyTavern). Não escolha pastas de personagens individuais e nem o diretório data diretamente.

A importação pode modificar meus arquivos no SillyTavern?

Não. O importador opera em modo de apenas leitura. Ele apenas lê o diretório do SillyTavern e grava cópias dos recursos no banco de dados e área de trabalho independentes do Tavern Studio. Seus arquivos originais não sofrem qualquer modificação.

Quais tipos de dados posso importar?

O Tavern Studio consegue importar cartões de personagem, World Info / Lorebooks, presets compatíveis com OpenAI, chaves/configurações de API e históricos de chat em JSONL padrão.

Meus históricos de chat antigos serão importados?

Sim, históricos de chats que seguem o formato JSONL padrão vinculados aos personagens serão migrados. Cada arquivo de chat vira uma conversa separada mantendo a ordem das mensagens. Arquivos de chat corrompidos ou com formato inválido podem ser ignorados.

Chats em grupo são suportados?

Chats em grupo não são totalmente suportados nesta fase. O importador pode pular dados de chats em grupo incompatíveis para prevenir a criação de históricos quebrados.

Por que certos servidores locais ou proxies exigem preenchimento manual?

Configurações personalizadas de endpoints, proxies inversos, configurações de LLM local (como Ollama ou LM Studio), Azure OpenAI e Cloudflare Workers AI dependem de nomes de host, IDs de conta ou rotas específicas difíceis de mapear de forma automatizada. Você precisará digitar esses dados manualmente no painel de configurações de API.

O que fazer se os personagens ou mídias importadas não aparecerem?

Verifique o log de importação em busca de possíveis erros. Caso o processo tenha ocorrido com sucesso, recarregue a página ou reinicie o Tavern Studio para forçar a atualização do banco de dados de recursos do aplicativo.

Preciso fazer backup antes de migrar?

Embora o importador opere no modo apenas leitura, realizar um backup prévio dos dados originais do SillyTavern é sempre recomendável antes de rodar qualquer rotina de migração.

Próximo Passo