Android (Termux) Installation
发布时间:2026-11-06 | 浏览:1
SillyTavern can be run natively on Android devices using Termux.
Installing Termux
Avoid installing Termux from the Google Play Store, that version is no longer maintained. Instead, use F-Droid (recommended) or GitHub releases to get the latest version.
Download Termux from F-Droid or GitHub releases .
Install the downloaded APK file.
Open Termux and run your first command: termux-change-repo
Open Termux and run your first command:
Select "Mirror group" and choose your closest servers. You can touch the screen or use swipe gestures with Unexpected Keyboard .
Update Termux: pkg update && pkg upgrade
Installing Dependencies
Install the required packages:
If you're running 32-bit Android, see the Common Errors section below for additional steps.
Installing SillyTavern
Clone the SillyTavern repository ( How to Choose a Branch ):
Release Branch: git clone https://github.com/SillyTavern/SillyTavern -b release
Release Branch:
Staging Branch: git clone https://github.com/SillyTavern/SillyTavern -b staging
Staging Branch:
Running SillyTavern
To run SillyTavern, navigate to the cloned directory and run the start script:
To update SillyTavern, navigate to the SillyTavern directory and run:
See the Aliases section below for creating shortcuts to simplify this process.
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:
Then proceed with the installation steps above.
Performance tweaks
For general tips on improving performance, see the respective FAQ section .
Due to hardware limitations on Android devices, you may want to adjust the following SillyTavern config.yaml settings for better memory, storage, and CPU usage:
Use the nano text editor included with Termux to edit the config.yaml file: nano ~/SillyTavern/config.yaml
Optional: Create Aliases
You can create shortcuts for common commands to make your workflow easier.
Open an editor to modify your .bashrc file: nano ~/.bashrc
Open an editor to modify your .bashrc file:
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'
Add the following lines to create aliases:
Save the file and exit the editor (in nano, press CTRL + X , then Y , then Enter ).
Save the file and exit the editor (in nano, press CTRL + X , then Y , then Enter ).
To apply the changes, run: source ~/.bashrc
To apply the changes, run:
Now you can use the following commands:
st to start SillyTavern
stup to update SillyTavern
pkgup to update Termux packages
Further Reading
The guides linked below are not maintained by the SillyTavern team.
SillyTavern in Termux guide by ArroganceComplex#2659: https://rentry.org/STAI-Termux
Accessing Termux files with Material Files: https://www.learntermux.tech/2020/10/Termux-File-Manager.html
Prevent Termux process deep sleep: https://wiki.termux.com/wiki/Termux-wake-lock