Upload 4 files

Dockerfile

@@ -0,0 +1,26 @@
+FROM python:3.11-slim
+
+ENV DEBIAN_FRONTEND=noninteractive \
+    PIP_NO_CACHE_DIR=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PORT=7860 \
+    VOICES_DIR=/voices
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl ca-certificates espeak-ng \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN pip install --no-cache-dir \
+    "piper-tts" \
+    "fastapi" \
+    "uvicorn[standard]"
+
+WORKDIR /app
+COPY app.py /app/app.py
+COPY start.sh /app/start.sh
+RUN chmod +x /app/start.sh && mkdir -p ${VOICES_DIR}
+
+EXPOSE 7860
+
+CMD ["/app/start.sh"]

README.md

@@ -1,10 +1,52 @@
 ---
-title: Palmtts
-emoji: 🏃
-colorFrom: pink
-colorTo: pink
+title: Palm Tree TTS
+emoji: 🌴
+colorFrom: yellow
+colorTo: red
 sdk: docker
-pinned: false
+app_port: 7860
+pinned: true
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🌴 Palm Tree TTS
+
+Bilingual Piper text-to-speech for the **Under The Palm Tree** games.
+
+- 🇬🇧 English voice: `en_GB-alan-low` (Alan, British)
+- 🇯🇴 Arabic voice: `ar_JO-kareem-medium` (Kareem, Jordanian)
+
+## API
+
+```
+POST /synthesize
+Content-Type: application/json
+{ "text": "Welcome to Samail.", "lang": "en" }
+```
+
+Returns `audio/wav` (16-bit PCM).
+
+You can also pass `"voice": "en_GB-alan-low"` instead of `lang`.
+
+```
+GET /        -> {"status": "ready", "voices": [...]}
+GET /healthz -> "ok"
+POST /tts    -> alias for /synthesize
+```
+
+CORS is open so the games can call this Space from any origin.
+
+## How the voices load
+
+At container start, `start.sh` downloads the two `.onnx` voice models and
+their `.onnx.json` configs from the GitHub raw URLs at
+`thuraya1988/123Learning-English-Under-The-Palm-Tree/main/public/tts-voices/`.
+
+That keeps the Space in sync with whatever Thuraya last uploaded to the repo.
+
+## Deploying
+
+1. Create a Hugging Face Space named `palm-tree-tts` under owner `Thursday88`.
+2. **SDK: Docker** — required.
+3. Upload `Dockerfile`, `app.py`, `start.sh`, and this `README.md`.
+4. Wait 3–5 minutes for the build.
+5. The Space serves on `https://thursday88-palm-tree-tts.hf.space`.

app.py

@@ -0,0 +1,105 @@
+"""Piper TTS HTTP server for the Under-The-Palm-Tree games.
+
+Exposes a tiny REST API that the games' piper-client.js can call directly
+from the browser. CORS is wide open so any origin (Vercel, GitHub Pages,
+Squarespace iframes) can use it.
+
+POST /synthesize  {"text": "...", "voice": "en_GB-alan-low" | "ar_JO-kareem-medium"}
+POST /tts         {"text": "...", "lang": "en" | "ar"}
+GET  /healthz     -> "ok"
+GET  /            -> {"status": "ready", "voices": [...]}
+
+Each POST returns audio/wav (16-bit PCM).
+"""
+import io
+import os
+import wave
+from pathlib import Path
+
+from fastapi import FastAPI, HTTPException
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import Response, JSONResponse
+from pydantic import BaseModel
+from piper import PiperVoice
+
+VOICES_DIR = Path(os.environ.get("VOICES_DIR", "/voices"))
+DEFAULT_VOICE = "en_GB-alan-low"
+
+LANG_VOICE_MAP = {
+    "ar": "ar_JO-kareem-medium",
+    "en": "en_GB-alan-low",
+}
+
+app = FastAPI(title="Palm Tree TTS — Piper")
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_methods=["GET", "POST", "OPTIONS"],
+    allow_headers=["*"],
+)
+
+_voice_cache: dict = {}
+
+
+def load_voice(name: str):
+    if name in _voice_cache:
+        return _voice_cache[name]
+    onnx = VOICES_DIR / f"{name}.onnx"
+    cfg = VOICES_DIR / f"{name}.onnx.json"
+    if not onnx.exists() or not cfg.exists():
+        raise HTTPException(status_code=404, detail=f"voice '{name}' not found")
+    _voice_cache[name] = PiperVoice.load(str(onnx), config_path=str(cfg))
+    return _voice_cache[name]
+
+
+def available_voices():
+    return sorted(p.stem for p in VOICES_DIR.glob("*.onnx"))
+
+
+def synth_wav(text: str, voice_name: str) -> bytes:
+    voice = load_voice(voice_name)
+    buf = io.BytesIO()
+    with wave.open(buf, "wb") as wf:
+        # Newer piper-tts uses synthesize_wav; fall back to synthesize for older builds.
+        synth = getattr(voice, "synthesize_wav", None) or voice.synthesize
+        synth(text, wf)
+    return buf.getvalue()
+
+
+class SynthRequest(BaseModel):
+    text: str
+    voice: str | None = None
+    lang: str | None = None
+
+
+@app.get("/")
+def root():
+    return JSONResponse({"status": "ready", "voices": available_voices()})
+
+
+@app.get("/healthz")
+def healthz():
+    return Response("ok", media_type="text/plain")
+
+
+def resolve_voice(req: SynthRequest) -> str:
+    if req.voice:
+        return req.voice
+    if req.lang:
+        return LANG_VOICE_MAP.get(req.lang.lower(), DEFAULT_VOICE)
+    return DEFAULT_VOICE
+
+
+@app.post("/synthesize")
+def synthesize(req: SynthRequest):
+    text = (req.text or "").strip()
+    if not text:
+        raise HTTPException(status_code=400, detail="text is required")
+    audio = synth_wav(text, resolve_voice(req))
+    return Response(audio, media_type="audio/wav")
+
+
+@app.post("/tts")
+def tts(req: SynthRequest):
+    return synthesize(req)

start.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+VOICES_DIR="${VOICES_DIR:-/voices}"
+BASE_URL="https://raw.githubusercontent.com/thuraya1988/123Learning-English-Under-The-Palm-Tree/main/public/tts-voices"
+
+mkdir -p "${VOICES_DIR}"
+
+for f in \
+    "en_GB-alan-low.onnx" \
+    "en_GB-alan-low.onnx.json" \
+    "ar_JO-kareem-medium.onnx" \
+    "ar_JO-kareem-medium.onnx.json"
+do
+    out="${VOICES_DIR}/${f}"
+    if [[ ! -s "${out}" ]]; then
+        echo "Downloading ${f}..."
+        curl -fsSL "${BASE_URL}/${f}" -o "${out}"
+    fi
+done
+
+echo "Voices ready in ${VOICES_DIR}:"
+ls -lh "${VOICES_DIR}"
+
+exec uvicorn app:app --host 0.0.0.0 --port "${PORT:-7860}"