# Android (Termux) Installation

SillyTavern can be run natively on Android devices using Termux.

# Installing Termux

  1. Download Termux from F-Droid or GitHub releases.
  2. Install the downloaded APK file.
  3. Open Termux and run your first command:

    termux-change-repo
  4. Select "Mirror group" and choose your closest servers. You can touch the screen or use swipe gestures with Unexpected Keyboard.
  5. Update Termux:

    pkg update && pkg upgrade

# Installing Dependencies

Install the required packages:

pkg install git nodejs-lts nano

# Installing SillyTavern

Clone the SillyTavern repository (How to Choose a Branch):

  • Release Branch:

    git clone https://github.com/SillyTavern/SillyTavern -b release
  • Staging Branch:

    git clone https://github.com/SillyTavern/SillyTavern -b staging

# Running SillyTavern

To run SillyTavern, navigate to the cloned directory and run the start script:

cd ~/SillyTavern
bash start.sh

To update SillyTavern, navigate to the SillyTavern directory and run:

cd ~/SillyTavern
git pull --rebase --autostash

See the Aliases section below for creating shortcuts to simplify this process.

# Common Errors

# Unsupported platform: android arm LEtime-web

32-bit Android requires an external dependency that can't be installed with npm.

Use the following command to install it:

pkg install esbuild

Then proceed with the installation steps above.

# Optional: Create Aliases

You can create shortcuts for common commands to make your workflow easier.

  1. Open an editor to modify your .bashrc file:

    nano ~/.bashrc
  2. Add the following lines to create aliases:

    # Update Termux packages
    alias pkgup="pkg update && pkg upgrade"
    #Start SillyTavern
    alias st='cd ~/SillyTavern && bash start.sh'
    # Update SillyTavern
    alias stup='cd ~/SillyTavern && git pull --rebase --autostash'
  3. Save the file and exit the editor (in nano, press CTRL + X, then Y, then Enter).

  4. To apply the changes, run:

    source ~/.bashrc

Now you can use the following commands:

  • st to start SillyTavern
  • stup to update SillyTavern
  • pkgup to update Termux packages

# Further Reading