Last translated: 16 Jun 2025

Translation Not Available Yet

This repository's README hasn't been translated yet. Once translated, it will be easier to read and understand in your native language (中文).

After translating, add the links to README so others can view it directly.


SillyTavern ofrece una interfaz unificada para múltiples APIs de LLM (KoboldAI/CPP, Horde, NovelAI, Ooba, Tabby, OpenAI, OpenRouter, Claude, Mistral y más), un diseño adaptable a móviles, Modo Novela Visual, integración con APIs de generación de imágenes Automatic1111 & ComfyUI, TTS, WorldInfo (lorebooks), UI personalizable, auto-traducción, más opciones de prompts de las que jamás necesitarías, y potencial de crecimiento ilimitado mediante extensiones de terceros.

Tenemos un sitio de Documentación para responder la mayoría de tus preguntas y ayudarte a comenzar.

¿Qué es SillyTavern?

SillyTavern (o ST para abreviar) es una interfaz de usuario instalada localmente que te permite interactuar con modelos de generación de texto LLM, motores de generación de imágenes y modelos de voz TTS.

Comenzando en febrero de 2023 como un fork de TavernAI 1.2.8, SillyTavern cuenta ahora con más de 200 colaboradores y 2 años de desarrollo independiente, y sigue siendo un software líder para entusiastas de IA.

Nuestra Visión

  1. Buscamos empoderar a los usuarios con el máximo control y utilidad sobre sus prompts de LLM. ¡La curva de aprendizaje es parte de la diversión!
  2. No ofrecemos servicios en línea ni alojados, ni rastreamos datos de usuarios programáticamente.
  3. SillyTavern es un proyecto de pasión creado por una comunidad dedicada de entusiastas de LLM, y siempre será gratuito y de código abierto.

Ramas

SillyTavern se desarrolla usando un sistema de dos ramas para garantizar una experiencia fluida.

  • release - 🌟 Recomendado para la mayoría de usuarios. La rama más estable, actualizada solo con lanzamientos importantes. Adecuada para la mayoría. Normalmente se actualiza una vez al mes.
  • staging - ⚠️ No recomendado para uso casual. Contiene las últimas funciones, pero puede fallar en cualquier momento. Solo para usuarios avanzados. Se actualiza varias veces al día.

Si no estás familiarizado con git CLI o no sabes qué es una rama, ¡no te preocupes! La rama release siempre será la mejor opción para ti.

¿Qué necesito además de SillyTavern?

Como SillyTavern es solo una interfaz, necesitarás un backend LLM para la inferencia. Puedes usar AI Horde para chatear inmediatamente. Además, soportamos muchos otros backends locales y en la nube: API compatible con OpenAI, KoboldAI, Tabby y más. Lee más sobre las APIs soportadas en la Documentación.

¿Necesito un PC potente para ejecutar SillyTavern?

Los requisitos de hardware son mínimos: funciona en cualquier sistema que ejecute NodeJS 18 o superior. Para inferencia local de LLM, recomendamos una tarjeta gráfica NVIDIA serie 3000 con al menos 6GB de VRAM. Consulta la documentación de tu backend para más detalles.

Backends sugeridos (no afiliados)

  • AI Horde - usa modelos alojados por voluntarios. No requiere configuración adicional
  • KoboldCpp - favorito de la comunidad para ejecutar modelos GGUF localmente
  • tabbyAPI - una API ligera y popular para inferencia local exl2
  • OpenRouter - una única API para múltiples proveedores en la nube (OpenAI, Claude, Meta Llama, etc.) y modelos comunitarios populares.

¿Preguntas o sugerencias?

Servidor de Discord

¡Únete a nuestra comunidad en Discord! Obtén soporte, comparte personajes y prompts favoritos.

O contacta directamente con los desarrolladores:

¡Me gusta tu proyecto! ¿Cómo puedo contribuir?

  1. Envía pull requests. Aprende cómo contribuir: CONTRIBUTING.md
  2. Envía sugerencias e informes de errores usando las plantillas proporcionadas.
  3. Lee este archivo README completo y consulta el sitio de documentación primero, para evitar enviar issues duplicados.

Capturas de pantalla

image image

Tarjetas de Personaje

SillyTavern se basa en el concepto de "tarjetas de personaje". Una tarjeta es un conjunto de prompts que definen el comportamiento del LLM y son necesarias para conversaciones persistentes. Funcionan similar a los GPTs de ChatGPT o bots de Poe. El contenido puede ser cualquier cosa: un escenario abstracto, un asistente para tareas específicas, una personalidad famosa o un personaje ficticio.

Para chatear rápidamente sin seleccionar una tarjeta o probar la conexión LLM, escribe tu prompt en la barra de entrada en la pantalla de bienvenida. Esto creará una tarjeta vacía de "Asistente" que puedes personalizar después.

Para entender cómo definir tarjetas, consulta el personaje predeterminado (Seraphina) o descarga tarjetas comunitarias desde el menú "Descargar Extensiones y Recursos".

Características Principales

  • Configuración avanzada de generación de texto con presets comunitarios
  • Soporte para World Info: crea lore detallado o ahorra tokens en tu tarjeta
  • Chats grupales: salas multi-bot para que los personajes hablen contigo y/o entre sí
  • Personalización de UI: colores, imágenes de fondo, CSS personalizado, etc.
  • Personas de usuario: permite que la IA sepa más sobre ti para mayor inmersión
  • Soporte RAG integrado: añade documentos a tus chats para referencia de la IA
  • Subsistema extenso de comandos y propio motor de scripting

Extensiones

SillyTavern soporta extensiones.

  • Expresiones emocionales de personajes (sprites)
  • Auto-resumen del historial de chat
  • Traducción automática de UI y chats
  • Generación de imágenes con Stable Diffusion/FLUX/DALL-E
  • Texto a voz para respuestas de IA (via ElevenLabs, Silero o TTS del sistema)
  • Búsqueda web para añadir contexto del mundo real a tus prompts
  • Muchas más disponibles en el menú "Descargar Extensiones y Recursos".

Tutoriales disponibles en la Documentación.

⌛ Instalación

🪟 Windows

[!ADVERTENCIA]

  • NO INSTALAR EN CARPETAS CONTROLADAS POR WINDOWS (Program Files, System32, etc).
  • NO EJECUTAR START.BAT CON PERMISOS DE ADMINISTRADOR
  • INSTALACIÓN EN WINDOWS 7 ES IMPOSIBLE PORQUE NO SOPORTA NODEJS 18.16

Instalación via Git (recomendado)

  1. Instala NodeJS (última versión LTS recomendada)
  2. Instala Git for Windows
  3. Abre el Explorador de Windows (Win+E)
  4. Navega o crea una carpeta no controlada por Windows (ej: C:\MiCarpetaEspecial)
  5. Abre un Símbolo del sistema en esa carpeta escribiendo cmd en la barra de direcciones y presionando Enter.
  6. En la ventana negra (Símbolo del sistema), escribe UNO de los siguientes comandos y presiona Enter:
  • Para la rama Release: git clone https://github.com/SillyTavern/SillyTavern -b release
  • Para la rama Staging: git clone https://github.com/SillyTavern/SillyTavern -b staging
  1. Una vez clonado, haz doble clic en Start.bat para que NodeJS instale los requisitos.
  2. El servidor iniciará y SillyTavern se abrirá en tu navegador.

Instalación via GitHub Desktop

(Permite uso de git solo en GitHub Desktop. Si quieres usar git en la línea de comandos, instala también Git for Windows)

  1. Instala NodeJS (última versión LTS recomendada)
  2. Instala GitHub Desktop
  3. Haz clic en Clone a repository from the internet.... (Nota: NO necesitas una cuenta de GitHub)
  4. En la pestaña URL, ingresa https://github.com/SillyTavern/SillyTavern y haz clic en Clone. Puedes cambiar la ruta local.
  5. Navega a la carpeta donde clonaste el repositorio (por defecto: C:\Users\[TuUsuario]\Documents\GitHub\SillyTavern)
  6. Haz doble clic en start.bat (el nombre puede aparecer como "Start" si la extensión está oculta)
  7. Se abrirá una ventana de consola y SillyTavern comenzará a instalarse.
  8. Si todo funciona, la consola mostrará un mensaje y SillyTavern se abrirá en tu navegador.
  9. ¡Conéctate a cualquier API soportada y comienza a chatear!

🐧 Linux & 🍎 MacOS

Para MacOS/Linux, todos los pasos se realizan en una Terminal.

  1. Instala git y nodeJS (el método varía según tu SO)
  2. Clona el repositorio:
  • Para la rama Release: git clone https://github.com/SillyTavern/SillyTavern -b release
  • Para la rama Staging: git clone https://github.com/SillyTavern/SillyTavern -b staging
  1. cd SillyTavern para entrar en la carpeta de instalación.
  2. Ejecuta el script start.sh con uno de estos comandos:
  • ./start.sh
  • bash start.sh

🐋 Instalación via Docker

Estas instrucciones asumen que tienes Docker instalado, acceso a la línea de comandos y familiaridad con su operación básica.

Usando GitHub Container Registry

Docker Compose (más fácil)

Descarga el archivo docker-compose.yml del Repositorio GitHub y ejecuta este comando en el directorio donde está el archivo. Esto descargará la última imagen release y creará los volúmenes necesarios.

docker-compose up

Personaliza docker-compose.yml según tus necesidades. El puerto predeterminado es 8000. Para ajustar la configuración con variables de entorno, consulta la documentación.

Docker CLI (avanzado)

Necesitarás mapeos de directorio obligatorios y un mapeo de puerto. Reemplaza en el comando:

Variables del Contenedor

Mapeos de Volumen
  • CONFIG_PATH - Directorio para archivos de configuración en tu máquina
  • DATA_PATH - Directorio para datos de usuario (incluyendo personajes)
  • PLUGINS_PATH - (opcional) Directorio para plugins del servidor
  • EXTENSIONS_PATH - (opcional) Directorio para extensiones globales de UI
Mapeos de Puerto
  • PUBLIC_PORT - Puerto para exponer el tráfico. Obligatorio para acceder desde fuera del contenedor. NO lo expongas a internet sin seguridad adicional.
Configuración Adicional
  • SILLYTAVERN_VERSION - En la página de GitHub, en "Packages", selecciona "sillytavern" para ver las versiones. La etiqueta "latest" te mantendrá actualizado con el release actual. También puedes usar "staging" para la imagen nightly.

Ejecutando el contenedor

  1. Abre tu Línea de Comandos
  2. Ejecuta el siguiente comando en una carpeta donde quieras almacenar los archivos:
SILLYTAVERN_VERSION="latest"
PUBLIC_PORT="8000"
CONFIG_PATH="./config"
DATA_PATH="./data"
PLUGINS_PATH="./plugins"
EXTENSIONS_PATH="./extensions"

docker run \
  --name="sillytavern" \
  -p "$PUBLIC_PORT:8000/tcp" \
  -v "$CONFIG_PATH:/home/node/app/config:rw" \
  -v "$DATA_PATH:/home/node/app/data:rw" \
  -v "$EXTENSIONS_PATH:/home/node/app/public/scripts/extensions/third-party:rw" \
  -v "$PLUGINS_PATH:/home/node/app/plugins:rw" \
  ghcr.io/sillytavern/sillytavern:"$SILLYTAVERN_VERSION"

Por defecto el contenedor se ejecuta en primer plano. Para ejecutarlo en segundo plano, añade el flag -d al comando docker run.

Construyendo la imagen tú mismo

Tenemos una guía completa sobre Docker aquí que cubre instalaciones en Windows, macOS y Linux. ¡Léela si quieres construir la imagen manualmente!

⚡ Instalación via SillyTavern Launcher

SillyTavern Launcher es un asistente que te ayuda a configurar muchas opciones, incluyendo backends para inferencia local.

Para usuarios de Windows

  1. Presiona WINDOWS + R, luego ejecuta:
cmd /c winget install -e --id Git.Git
  1. Presiona WINDOWS + E, navega a la carpeta deseada, escribe cmd en la barra de direcciones y presiona Enter. Luego ejecuta:
git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher && start installer.bat

Para usuarios de Linux

  1. Abre una terminal e instala git
  2. Clona el Launcher con:
git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
  1. Inicia el instalador con:
chmod +x install.sh && ./install.sh
  1. Después de instalar, inicia el launcher con:
chmod +x launcher.sh && ./launcher.sh

Para usuarios de Mac

  1. Abre una terminal e instala brew con:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. Instala git con:
brew install git
  1. Clona el Launcher con:
git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
  1. Inicia el instalador con:
chmod +x install.sh && ./install.sh
  1. Después de instalar, inicia el launcher con:
chmod +x launcher.sh && ./launcher.sh

📱 Instalación via Termux en Android OS

[!NOTA] SillyTavern puede ejecutarse nativamente en Android usando Termux, pero no ofrecemos soporte oficial para este caso.

Consulta esta guía de ArroganceComplex#2659:

Plataforma no soportada: android arm LEtime-web. Android de 32-bit requiere una dependencia externa que no puede instalarse con npm. Usa este comando para instalarla: pkg install esbuild. Luego sigue los pasos normales de instalación.

Argumentos de línea de comandos

Puedes pasar argumentos al inicio del servidor para sobrescribir configuraciones en config.yaml.

Ejemplos

node server.js --port 8000 --listen false
# or
npm run start -- --port 8000 --listen false
# or (Windows only)
Start.bat --port 8000 --listen false

Argumentos soportados

[!TIP] Ningún argumento es obligatorio. Si no los proporcionas, SillyTavern usará las configuraciones en config.yaml.

OpciónDescripciónTipo
--versionMostrar número de versiónboolean
--configPathSobrescribir la ruta al archivo config.yamlstring
--dataRootDirectorio raíz para almacenamiento de datosstring
--portEstablece el puerto en el que se ejecutará SillyTavernnumber
--listenSillyTavern escuchará en todas las interfaces de redboolean
--whitelistHabilita el modo de lista blancaboolean
--basicAuthModeHabilita autenticación básicaboolean
--enableIPv4Habilita el protocolo IPv4boolean
--enableIPv6Habilita el protocolo IPv6boolean
--listenAddressIPv4Dirección IPv4 específica para escucharstring
--listenAddressIPv6Dirección IPv6 específica para escucharstring
--dnsPreferIPv6Prefiere IPv6 para DNSboolean
--sslHabilita SSLboolean
--certPathRuta a tu archivo de certificadostring
--keyPathRuta a tu archivo de clave privadastring
--autorunLanza automáticamente SillyTavern en el navegadorboolean
--autorunHostnameNombre de host para autorunstring
--autorunPortOverrideSobrescribe el puerto para autorunstring
--avoidLocalhostEvita usar 'localhost' para autorun en modo automáticoboolean
--corsProxyHabilita proxy CORSboolean
--requestProxyEnabledHabilita el uso de proxy para solicitudes salientesboolean
--requestProxyUrlURL del proxy de solicitud (protocolos HTTP o SOCKS)string
--requestProxyBypassLista de bypass para proxy de solicitud (lista de hosts separados por espacios)array
--disableCsrfDesactiva la protección CSRF (NO RECOMENDADO)boolean

Conexiones remotas

Normalmente esto es para personas que desean usar SillyTavern en sus teléfonos móviles mientras su PC ejecuta el servidor de ST en la misma red Wi-Fi. Sin embargo, también puede usarse para permitir conexiones remotas desde cualquier lugar.

Lee la guía detallada sobre cómo configurar conexiones remotas en la Documentación.

También puedes configurar perfiles de usuario en SillyTavern con protección por contraseña (opcional): Usuarios.

Licencia y créditos

Este programa se distribuye con la esperanza de que sea útil, pero SIN NINGUNA GARANTÍA; incluso sin la garantía implícita de COMERCIALIZACIÓN o IDONEIDAD PARA UN PROPÓSITO PARTICULAR. Consulta la Licencia Pública General Affero de GNU para más detalles.

  • TavernAI 1.2.8 por Humi: Licencia MIT
  • Partes del mod TavernAITurbo de CncAnon usadas con permiso
  • Modo Visual Novel inspirado en el trabajo de PepperTaco (https://github.com/peppertaco/Tavern/)
  • Fuente Noto Sans por Google (licencia OFL)
  • Tema de iconos por Font Awesome https://fontawesome.com (Iconos: CC BY 4.0, Fuentes: SIL OFL 1.1, Código: Licencia MIT)
  • Contenido predeterminado por @OtisAlejandro (personaje Seraphina y libro de lore) y @kallmeflocc (Fondo de Celebración de 10K Usuarios de Discord)
  • Guía de Docker por @mrguymiah y @Bronya-Rand
  • Biblioteca kokoro-js por @hexgrad (Licencia Apache-2.0)

Principales colaboradores

Contributors