File size: 1,265 Bytes
eb426ec 9ce7ac5 0d3686b 9ce7ac5 eb426ec 9ce7ac5 eb426ec 9ce7ac5 eb426ec 9ce7ac5 eb426ec 0d3686b eb426ec 0d3686b eb426ec 0d3686b eb426ec | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 | ---
title: SPITITOUT
emoji: 🔥
colorFrom: red
colorTo: green
sdk: docker
app_port: 7860
---
<div align="center">
<img width="1200" height="475" alt="GHBanner" src="https://github.com/user-attachments/assets/0aa67016-6eaf-458a-adb2-6e31a0763ed6" />
</div>
# SPITITOUT
This version is set up for a Hugging Face Docker Space. It does not use Gemini or any external model API; the Space loads local Hugging Face models for chat, speech recognition, and speech synthesis.
## Models
- Text on CPU Space: `Qwen/Qwen3-1.7B-GGUF` with llama.cpp / GGUF quantization
- Text on GPU Space: `Qwen/Qwen3-4B-Instruct-2507` with Transformers, or vLLM if you add a dedicated vLLM server
- Speech to text: `openai/whisper-tiny`
- Text to speech: `hexgrad/Kokoro-82M` through the `kokoro` Python package, Mandarin voice `zf_xiaobei`
For a CPU-only Space, keep `LLM_BACKEND=llamacpp`. To switch back to Transformers, set `LLM_BACKEND=transformers` and update `TEXT_MODEL`.
## Run locally
```bash
npm install
npm run build
pip install -r requirements.txt
python app.py
```
Open `http://localhost:7860`.
## Deploy to Hugging Face Spaces
Create a Docker Space, then push this folder. The included `Dockerfile` builds the React frontend and serves it from the FastAPI backend.
|