Skip to content
View TavernAI's full-sized avatar

Block or report TavernAI

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
TavernAI/README.md

TavernAI logo TavernAI 2

A private, portable AI roleplay chat for characters, branching scenes, and complete prompt control.

Latest release Total downloads Discord online

Website  •  Documentation  •  Discord  •  Releases

TavernAI 2 chat, Prompt Manager, and character library

TavernAI 2 gives roleplay chats room to change. A scene can branch at any message, bring new characters into the cast, run several replies at once, and use its own prompts, rules, images, files, and scripts.

Chats, cards, settings, and generated data stay on your machine. Connect a remote AI provider or run local LLM and vision models through CPU, CUDA, or Vulkan backends.

🚀 Download

System Package Download
Windows 10 / 11 Portable .zip, x64 (117 MB) Download v2.3.0
Linux Portable .tar.gz, x64 (120 MB) Download v2.3.0

For a VPS or Linux server:

curl -fsSL https://tavernai.net/install.sh | bash

✨ Beyond a Roleplay Chat

Run Models Locally or connect to AI Provider.

Load GGUF language and vision models directly inside TavernAI with CPU, CUDA, or Vulkan. Or switch the same chat to more than a dozen built-in and custom API integrations.

Local LLM model loading panel

Turn TavernAI into an AI Game Engine

Build interactive AI games with their own interface, persistent state, branching logic, scripts, and assets.

Scout RPG running inside TavernAI

MultiChat — One World, Many Lives

Give every character their own history and knowledge. Bring their timelines together when they meet, preserve that shared event in each life, then let their stories separate and continue again.

MultiChat Project and Timeline

Build the Prompt as a System

Control the entire generation pipeline with folders, activation rules, roles, placement, presets, token counters, structural nodes, and visual merge groups.

Structured Prompt Manager tree

Drop Files Straight into the Prompt

Attach images, PDFs, documents, audio, video, or text directly to any prompt item. Files become part of the same context system as characters, scenes, and chat history.

File attached to a Prompt Manager item

See Exactly What the Model Sees

Open the final assembled prompt before generation: every role, source, token, attachment, transformation, and the raw request itself.

Final Prompt Preview tree

Every Character Is Its Own Prompt System

Build each character from an ordered prompt tree with any prompts, folders, rules, scripts, files, and structure it needs. The avatar, identity, and complete behavior travel together in one card.

Character card with its Prompt Manager

Any Character Can Be Played by the AI or the User

Add any number of participants and decide independently who generates replies, who represents the user, and whose information enters the model context.

Chat participant role controls

Make the Entire Interface Yours

Rebuild TavernAI around your own colors, surfaces, typography, opacity, and chat style—then save the result as a reusable theme.

Theme Editor and customized interface

📄 Documentation

Translation sources for the app live in locales/. Documentation translation files live in docs-site/ when they are ready for community review.

👋 Community and Contributions

Join the TavernAI Discord. Bug reports and feature discussions belong in GitHub Issues.

Community contributions are open for app translations, documentation translations, typo fixes, and issue reports. Start with CONTRIBUTING.md.

This repository contains releases, translations, public documentation mirrors, issue tracking, and community files. The original TavernAI 1.x repository remains available as the legacy TavernAI repository.

🛡️ Privacity

TavernAI has no telemetry, crash reporting, background update checks, remote fonts, or external frameworks.

Popular repositories Loading

  1. TavernAI-v1 TavernAI-v1 Public

    Atmospheric adventure chat for AI language models (KoboldAI, NovelAI, Pygmalion, OpenAI chatgpt, gpt-4)

    JavaScript 2.7k 351

  2. TavernAI TavernAI Public

    An AI roleplay chat platform with the most advanced prompting system

    25 5

  3. TavernAIColab TavernAIColab Public

    JavaScript 23 11

  4. taicolabtest taicolabtest Public

    JavaScript 1 1