README.md

---
title: Hyperbolic Chat
emoji: 🚀
colorFrom: indigo
colorTo: pink
sdk: gradio
sdk_version: 6.2.0
app_file: app.py
hf_oauth: true
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