SillyTavern no Termux: como resolver erros de atualização, de desinstalação e do start.sh

Atualizado em 20 de setembro de 2026 · Android · Pelo desenvolvedor do LonelyTavern · Os comandos seguem o guia oficial do SillyTavern para Android

Este guia é sobre consertar o próprio SillyTavern, não substituí-lo. Pule para a seção que corresponde ao seu sintoma.

1. O Termux não consegue instalar nem atualizar nada

A causa mais comum em uma instalação nova: a versão do Termux da Play Store, que não é mais mantida e traz pacotes desatualizados. Desinstale-a e instale o Termux pelo F-Droid (recomendado) ou pelas releases do Termux no GitHub. Depois, atualize tudo:

pkg update && pkg upgrade

Se os downloads de pacotes travarem ou excederem o tempo limite, rode termux-change-repo, escolha outro mirror e tente de novo.

2. O start.sh funcionava — agora não funciona mais

A história de sempre: uma atualização de pacotes trocou o Node por baixo do SillyTavern, ou o Node foi instalado na versão não LTS desde o início. O guia oficial fixa o nodejs-lts; muitos tutoriais em vídeo dizem pkg install nodejs — só essa diferença já explica muito "funcionava semana passada". Siga estes passos, em ordem:

pkg update && pkg upgrade
pkg install nodejs-lts
cd ~/SillyTavern && git pull --rebase --autostash
bash start.sh

Se ainda falhar, faça um clone novo — mantendo seus dados:

mv ~/SillyTavern ~/SillyTavern-old
git clone https://github.com/SillyTavern/SillyTavern -b release
cp -r ~/SillyTavern-old/data ~/SillyTavern/
cd ~/SillyTavern && bash start.sh

Suas conversas, personagens e configurações ficam na pasta data; a instalação antiga fica em ~/SillyTavern-old até você ter certeza de que tudo veio junto.

3. O servidor morre quando a tela bloqueia

O Android encerra processos em segundo plano de forma agressiva, e um servidor Node dentro do Termux é um alvo preferencial. Em ordem de eficácia:

Rode termux-wake-lock (ou toque em Acquire wakelock na notificação do Termux) antes de sessões longas.
Tire o Termux da otimização de bateria: Settings → Apps → Termux → Battery → Unrestricted (Configurações → Apps → Termux → Bateria → Sem restrições). Os nomes dos menus variam conforme o fabricante, e alguns fabricantes (especialmente os de interfaces Android muito modificadas) encerram apps em segundo plano mesmo assim.
Para conversas longas, mantenha o Termux visível em tela dividida em vez de totalmente em segundo plano.

4. O npm falha durante a instalação (código de erro 134)

O erro 134 durante o npm install quase sempre é falta de memória em um celular com pouca RAM. Feche todos os outros apps e rode a instalação de novo; confira se o Node está na versão LTS (pkg install nodejs-lts). Em dispositivos de 32 bits, o guia oficial também exige pkg install esbuild.

5. Tudo está lento

Duas coisas para conferir.

Três configurações do config.yaml. O guia oficial para Android cita o carregamento sob demanda (lazy loading) de personagens, o cache em disco e os backups automáticos de conversas como as que devem ser revistas em um dispositivo com poucos recursos. A documentação traz os valores recomendados atuais.
O tamanho da sua biblioteca. O armazenamento do celular é lento. Arquivos de conversa muito grandes e bibliotecas com centenas de cartões custam tempo de carregamento de verdade, então mantenha a biblioteca no dispositivo enxuta.

6. Conversas ou personagens sumiram

Os relatos de perda de dados se concentram em gravações interrompidas — o app ou o celular encerrado no meio do salvamento, ou uma atualização que deu errado. Prevenir é melhor que recuperar. Rode termux-setup-storage uma vez para ter acesso ao armazenamento compartilhado e depois faça backup antes de cada atualização:

cp -r ~/SillyTavern/data ~/storage/shared/SillyTavern-backup

Se algo já sumiu: pare, não continue gravando e confira a pasta de backups do próprio SillyTavern dentro de data antes de pensar no pior.

7. A resposta morre quando você bloqueia o celular ou troca de app

Aqui o culpado não é o servidor. É o navegador. A resposta chega à aba aberta por uma conexão ativa, e os navegadores de celular suspendem abas em segundo plano em poucos segundos para economizar bateria, o que corta a transmissão. Três coisas ajudam:

Mantenha a tela ligada até a geração terminar.
Use a tela dividida, para que a aba nunca vá totalmente para o segundo plano.
Reduza o tamanho da resposta, para que as respostas terminem mais cedo.

O Firefox no Android costuma manter as abas em segundo plano vivas um pouco mais que o Chrome.

8. Desinstalar, ou recomeçar do zero

Não existe desinstalador. O SillyTavern é uma pasta dentro do Termux, então removê-lo significa apagar essa pasta, ou apagar o próprio Termux. Antes, faça backup da pasta data no armazenamento compartilhado, porque as duas opções levam suas conversas junto.

Os passos completos, incluindo uma reinstalação limpa que mantém suas conversas: como desinstalar o SillyTavern.

Se você prefere não rodar um servidor no celular

Tudo acima mantém o próprio SillyTavern funcionando. Se é isso que você quer, a documentação oficial é boa e a comunidade é prestativa.

Se você precisa mesmo é dos seus personagens, da sua chave de API e do seu celular, foi para isso que construímos o LonelyTavern. É um app nativo para Android e iPhone que importa cartões de personagem V3 e lorebooks no formato World Info, funciona com qualquer provedor compatível com a OpenAI usando a sua própria chave e mantém tudo no seu dispositivo.

Gratuito, sem conta, sem anúncios e nada para manter às 2 da manhã. Não é o SillyTavern completo: não tem extensões nem conversas em grupo. Para o essencial, é só instalar e usar.

Guias relacionados: SillyTavern no iPhone: três formas que funcionam · Chai: exporte e faça backup das suas conversas · Character.AI: exporte suas conversas e guarde-as · todos os guias.

SillyTavern e Termux são projetos independentes de seus respectivos autores. O LonelyTavern não é afiliado a nenhum dos dois projetos nem endossado por eles. Os comandos aqui seguem a documentação oficial do SillyTavern em docs.sillytavern.app — sempre confira lá as instruções atuais.