OpenRouter
You need an API key from the provider.
~/SillyTavern/data/default-user/settings.json
Get a key ↗Roleplay AI chat frontend that runs locally in your browser
SillyTavern · icon from the registry
Yours missing or too old? AiBOX installs a supported Node.js next to it and leaves the one you already have untouched.
Roleplay AI chat frontend that runs locally in your browser
Registry data updated: 2026-11-15
Config file written to
~/SillyTavern/data/default-user/settings.json
Everything stays on your own machine — nothing is uploaded. To uninstall, delete these folders.
One portable file for Windows (macOS coming). Double-click and it runs — no installer, no administrator rights.
Go to download →Open the AiBOX app catalog, find SillyTavern and press Install. AiBOX checks what your machine already has and installs only what is missing.
It downloads with a checksum check, writes the config and fills in your API key if the app needs one. You just click.
✓ Installed until it works.Prefer to do it by hand? The full written guide is right below. Read the guide ↓
The same steps in written form — follow along at your own pace.
One line: SillyTavern is a roleplay-focused AI chat frontend that runs on your own computer — you use it in a browser, connect practically any LLM (cloud API or a local model), and every character card, preset and chat stays on your machine.
127.0.0.1:8000: character cards, group chats, lorebooks, memory tools| Need | Notes |
|---|---|
| Windows 10/11 or macOS 12+ | Linux works too; no admin rights, everything lives in your home folder |
| Node.js 18+ | LTS from nodejs.org; check with node --version |
| Git | Required for extensions and updates (git-scm.com on Windows) |
| A model source | A cloud API key, or local Ollama / KoboldCpp. Zero-cost trial: AI Horde with key 0000000000 |
~/SillyTavern (hash-verified, CN traffic auto-routes through a proxy channel) and runs start.sh to fetch dependencieshttp://127.0.0.1:8000 in your browsergit clone --depth 1 -b 1.19.0 https://github.com/SillyTavern/SillyTavern.git ~/SillyTavern
cd ~/SillyTavern && ./start.sh # Windows: double-click Start.bat, or run in Git Bash
start.sh always runs npm install (idempotent) before starting the server — download cut off halfway? Just rerun the same command and it picks up where it left off.
release (recommended, cut roughly monthly, stable) and staging (multiple daily updates, can break any moment — enthusiasts only)release tag (e.g. 1.19.0). To upgrade: run git fetch && git checkout 1.x.y (or git pull) inside ~/SillyTavern, then ./start.sh — dependencies refresh automaticallygit checkout staging && ./start.sh; roll back the same way with git checkout releaseTop bar → API Connections → pick the type in the first dropdown, then the source:
| Type | Use it when | Typical sources |
|---|---|---|
| Chat Completion | Cloud conversational APIs (easiest) | OpenAI, Claude, Google, OpenRouter, DeepSeek |
| Text Completion | Local / continuation-style models — needs an Instruct template | Ollama, KoboldCpp, TabbyAPI, llama.cpp |
| AI Horde | Completely free volunteer compute, variable wait times | key 0000000000 works out of the box |
| Others | Niche needs | NovelAI, Mancer, Pollinations, … |
~/SillyTavern/data/default-user/ — copy that folder to migrateconfig.yaml under whitelistImportDomains (a guard against pulling arbitrary remote content)http://127.0.0.1:8000 opens (trust the URL printed in the terminal)npm could not be found: install Node.js 18+ and open a fresh terminal before rerunning ./start.sh./start.sh --port 8001 (arguments are passed straight through to the server; --listen exposes it on your LAN, --browserLaunchEnabled false skips auto-opening the browser)./start.sh to resume — finished node_modules work is not redoneollama serve) and the port matches--listen and configure a whitelist (./start.sh --listen --whitelist) — never expose it to the open internet unprotectedrm -rf ~/SillyTavern # program + character cards + chats live here — back up data/ first
rm -rf ~/AppData/Roaming/SillyTavern # Windows global-mode leftovers
rm -rf ~/Library/Application\ Support/SillyTavern # macOS global-mode leftovers
AiBOX's Manage → Uninstall does this for you. Export your characters and chats before deleting.
More: official docs · quick start · GitHub
AiBOX fills this in for you during the wizard — this section is for setting it up by hand.
You need an API key from the provider.
~/SillyTavern/data/default-user/settings.json
Get a key ↗You need an API key from the provider.
~/SillyTavern/data/default-user/settings.json
Get a key ↗You need an API key from the provider.
~/SillyTavern/data/default-user/settings.json
Get a key ↗You need an API key from the provider.
~/SillyTavern/data/default-user/settings.json
Get a key ↗Sign in with your account instead — no key to copy.
~/SillyTavern/data/default-user/settings.json
Get a key ↗Local model — no API key needed.
~/SillyTavern/data/default-user/settings.json
Runs on Windows / macOS — install it with AiBOX on any of them.
Difficulty 3 out of 5. AiBOX does the download and setup; your part is clicking through the wizard and pasting a key if the app needs one.
Everything stays on your own machine: ~/AppData/Roaming/SillyTavern / ~/Library/Application Support/SillyTavern. To uninstall, delete these — nothing is ever uploaded.
An outdated step, an error you do not understand, a typo — tell us and we will fix this page.
Upstream projects
Version numbers are re-checked by our daily probe — when upstream ships a new release, this page follows.
A wrong step, a confusing error, a typo — open an issue and someone will look.