Update README.md

README.md

@@ -11,3 +11,29 @@ license: mit
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+
+
+# 🎙️ Voice Chat — Hugging Face Space
+
+A simple Space that lets you **speak** to an AI and it **speaks back** (Gradio + OpenAI).
+
+## How to use on Spaces
+1. Create a new **Space** → SDK: **Gradio**.
+2. Upload `app.py` and `requirements.txt` from this repo.
+3. In your Space → **Settings → Variables and secrets**, add:
+   - `OPENAI_API_KEY` = `sk-...`
+   - *(optional)* `OPENAI_MODEL` = `gpt-4o-mini`
+4. Click **Restart this Space**. Press the mic, speak, or type.
+
+## Local run
+```bash
+pip install -r requirements.txt
+export OPENAI_API_KEY=sk-...
+python app.py
+```
+
+**Notes**
+- STT uses OpenAI `whisper-1`. TTS uses `gpt-4o-mini-tts`.
+- Change the system style and voice in the UI.
+