Update README.md

README.md

@@ -11,4 +11,37 @@ pinned: false
 ---
 
 
+# 🚀 Hyperbolic Chat Space
+
+Dies ist ein leistungsfähiges Chat-Interface für Large Language Models (LLMs), gehostet auf Hugging Face Spaces. Die Anwendung nutzt die **Hyperbolic API** für extrem schnelle Inferenz und integriert optional eine **Google Websuche**, um aktuelle Informationen bereitzustellen.
+
+## ✨ Hauptfunktionen
+
+* **⚡ High-Speed Inferenz:** Zugriff auf Top-Modelle wie `DeepSeek-V3`, `Llama-3.3-70B` und `Qwen-2.5` via Hyperbolic.
+* **🌐 Live Websuche:** Der Chatbot kann Google durchsuchen, um Fragen zu aktuellen Ereignissen zu beantworten (konfigurierbar).
+* **💰 Kosten-Transparenz:** Live-Anzeige der geschätzten Kosten pro Antwort basierend auf Token-Preisen.
+* **🔒 Sicherheit:** Integrierte Zugriffskontrolle via Hugging Face OAuth (Whitelisting).
+* **🎛️ Volle Kontrolle:** Anpassbare Parameter für `Temperature`, `Top-P`, `Max Tokens` und System-Prompts.
+
+## 🛠️ Einrichtung & Konfiguration
+
+Damit dieser Space funktioniert, müssen Umgebungsvariablen (Secrets) in den Space-Einstellungen hinterlegt werden.
+
+### 1. Umgebungsvariablen (Secrets)
+Gehe im Space zu **Settings** → **Variables and secrets** und füge folgende Keys hinzu:
+
+| Name | Beschreibung | Erforderlich? |
+| :--- | :--- | :--- |
+| `HYPERBOLIC_API_KEY` | Dein API-Schlüssel von [Hyperbolic](https://app.hyperbolic.xyz/). | ✅ **Ja** |
+| `GOOGLE_API_KEY` | API Key für die Google Custom Search JSON API. | ⚠️ (Nur für Suche) |
+| `GOOGLE_CX` | Die "Search Engine ID" deiner Google Custom Search Engine. | ⚠️ (Nur für Suche) |
+
+### 2. Zugriffskontrolle (Whitelist)
+Standardmäßig ist der Zugriff auf bestimmte Benutzer beschränkt. Dies wird direkt im Code in der Datei `app.py` definiert:
+
+```python
+ALLOWED_HF_USERS = {"dtometzki"}
+
+
+
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference