Update README.md

README.md

@@ -1,22 +1,55 @@
 ---
-title: Hannah AI Backend
-emoji: 🤖
-colorFrom: gray
-colorTo: gray
+title: Hannah-Pilot-Interface
+duplicate_from: null
 sdk: docker
-pinned: false
-license: mit
 app_port: 7860
 ---
 
-# Hannah AI Backend
+# Hannah Pilot Interface (Docker Space)
 
-This is the API engine for Hannah AI. 
+This HuggingFace Space serves a FastAPI backend for the Hannah web UI.
 
-## How to use
-1. This backend hosts the GGUF model files.
-2. It provides an API endpoint at `/api/chat` and `/api/models`.
-3. The frontend (hosted on GitHub or elsewhere) connects to this API via CORS.
+## ✅ Endpoints
 
-## Setup
-Upload your `.gguf` model files to the "Files" tab.
+- `GET /api/models` – lists available `.gguf` models in the repo
+- `GET /api/status` – lightweight health/status (RAM + CPU)
+- `POST /api/gen_title` – generates a short chat title
+- `POST /api/chat` – **streams NDJSON** responses (`application/x-ndjson`)
+
+## Frontend Setup
+
+In your HTML frontend, set:
+
+```js
+const API_BASE = "https://fugthchat-hannah-pilot-interface.hf.space";
+```
+
+Your frontend should call:
+- `POST ${API_BASE}/api/chat`
+- `GET ${API_BASE}/api/models`
+- `GET ${API_BASE}/api/status`
+
+## Models
+
+Upload your model files into the Space repo root:
+
+- `qwen2.5-0.5b-instruct-q2_k.gguf` (Light)
+- `qwen2.5-0.5b-instruct-q4_k_m.gguf` (Heavy)
+
+The backend auto-detects all `*.gguf` files.
+
+## Avoiding Build Loops
+
+This Space uses:
+- Docker listening on `0.0.0.0:7860`
+- `app_port: 7860` in the README header
+
+If your Space keeps restarting:
+1. Confirm the app listens on port `7860`.
+2. Confirm `CMD` runs `uvicorn app:app --host 0.0.0.0 --port 7860`.
+3. Check the Space logs for dependency install failures.
+
+## Notes
+
+- This is CPU-friendly config (`n_threads=2`) for HuggingFace free tier.
+- Response streaming is NDJSON (one JSON per line: `{ "text": "..." }`).