docs: add HuggingFace cache troubleshooting to README

- Document HF_HOME environment variable for writable cache
- Add systemd service permission guidance for /tmp paths
- Troubleshooting steps for read-only file system errors
This commit is contained in:
2026-02-26 15:56:09 -06:00
parent 85a334a57b
commit 9917d44f5d
36 changed files with 168 additions and 0 deletions

3
.env.testing Normal file → Executable file
View File

@@ -16,3 +16,6 @@ VOICES_DIR=./voices
# Default voice name (optional - uses first found voice if not set)
# This should match the filename without .wav extension (case-insensitive)
# DEFAULT_VOICE=masterchief
# HuggingFace cache directory (must be writable)
HF_HOME=/tmp/huggingface