README.md

---
title: '# Catan Regel-Experte (RAG App)'
sdk: gradio
emoji: 📚
colorFrom: gray
colorTo: blue
pinned: true
---
Diese Anwendung verwendet semantische Suche und KI (RAG), um Fragen zu den Catan-Spielregeln zu beantworten. Die Inhalte stammen aus echten PDF-Regelwerken und werden mit SBERT, FAISS und OpenAI/Groq verarbeitet.

## Live-Demo

[Hugging Face Space Link](https://huggingface.co/spaces/dewiri/Rag-Catan-Bot)

## Projektstruktur

- `app.py`: Gradio UI für Hugging Face
- `rag_pipeline.py`: Hauptlogik (Retrieval, Prompting, LLMs)
- `faiss/`: Vektorspeicher und Chunk-Mapping
- `requirements.txt`: Python-Abhängigkeiten

## Technologien

| Komponente         | Tool/Service                                |
|--------------------|---------------------------------------------|
| Embedding-Modelle  | `Sahajtomar/German-semantic` (Hugging Face) |
| Vektorsuche        | FAISS                                        |
| LLMs               | Groq LLaMA 3 & OpenAI GPT-4                  |
| UI                 | Gradio (Hugging Face Spaces)                 |

## Beispiel-Fragen

- „Welche Zahlen bringen am meisten Ertrag?“
- „Wie wird der Startspieler bestimmt?“
- „Wie viele Strassen brauche ich für längste Handelsstrasse?“