| --- |
| title: Ask PDFi |
| emoji: 🦉 |
| colorFrom: blue |
| colorTo: red |
| sdk: docker |
| pinned: false |
| license: mit |
| --- |
| |
| <div align="center"> |
| <img src="assets/pdfi-avatar.svg" width="160" alt="PDFi Logo"> |
| <h1>PDFi - Intelligenter PDF Assistent</h1> |
| <p><i>Ein smartes RAG-System, entwickelt für die interaktive Analyse von Dokumenten.</i></p> |
| </div> |
|
|
| --- |
|
|
| ## 📝 Projekt-Übersicht |
| Dieses Projekt vereint modernes UI/UX-Design mit leistungsstarker KI-Technologie. Es entstand im Rahmen meiner Spezialisierung zum **Fachinformatiker für Anwendungsentwicklung (FIAE)**. Der Fokus liegt auf einer nahtlosen User Experience, sauberem Branding und einer hochperformanten, lokalen Backend-Architektur auf Basis von Open-Source-Modellen. |
|
|
| ## 🛠️ Tech-Stack |
| * **Frontend:** Streamlit (Custom SVG-Branding & Base64-Injektion für optimierte Performance) |
| * **LLM:** Meta **Llama 3.1 8B Instruct** (GGUF-Quantisierung via `llama-cpp-python`) |
| * **Kontext:** Erweitertes Kontextfenster von **16.384 Token** für komplexe Analysen |
| * **Embeddings:** HuggingFace `all-MiniLM-L6-v2` (Lokal ausgeführt) |
| * **Vektor-Datenbank:** FAISS (In-Memory für blitzschnelle Ähnlichkeitssuche) |
| * **Framework:** LangChain & LangChain-Community |
| * **Infrastruktur:** Nvidia T4 GPU-Beschleunigung (Hugging Face Spaces Docker-Environment) |
|
|
| ## ✨ Kern-Features |
| * 📄 **Präzisions-Retrieval:** Automatisches Text-Splitting mit **Seitenzahl-Metadaten**. PDF'i weiß exakt, auf welcher Seite eine Information steht. |
| * ⚡ **High-Speed Inferenz:** GPU-beschleunigte RAG-Pipeline mit optimierter Retrieval-Tiefe ($k=25$) für fundierte Zusammenfassungen. |
| * 🎨 **Branding & UX:** Eigens entworfenes Maskottchen "PDFi" als optimiertes SVG-Favicon (1:1 Skalierung) für ein konsistentes Interface. |
| * 🔒 **Datensouveränität:** Lokale Inferenz innerhalb des Docker-Containers. Sensible Dokumentendaten verlassen niemals die gesicherte Umgebung. |
|
|
| ## 🏗️ Architektur & Design |
| Die Anwendung folgt dem Prinzip der strikten Trennung zwischen UI-Steuerung und Geschäftslogik. |
|
|
| <div align="center"> |
| <img src="assets/pdfi-uml.svg" alt="PDFi Architektur Diagramm" width="600"> |
| </div> |
|
|
| ## 🚀 Lokale Installation |
|
|
| 1. **Repository klonen:** |
| ```bash |
| git clone [https://huggingface.co/spaces/EX0SHIVA/Ask-PDFi](https://huggingface.co/spaces/EX0SHIVA/Ask-PDFi) |
| cd Ask-PDFi |
| ``` |
|
|
|
|
| 2. **Docker-Build & Start:** |
|
|
| ```bash |
| docker build -t pdfi-app . |
| docker run -p 7860:7860 --gpus all pdfi-app |
| ``` |
|
|
| ## 📖 Roadmap & Status |
| * ✅ **Projekt-Setup & Architekturplanung** |
| * ✅ **Implementierung der RAG-Logik** (`rag_core.py`) |
| * ✅ **UI-Entwicklung & Custom Branding** (`app.py`) |
| * ✅ **Deployment auf Hugging Face Spaces** |
| * ⬜ **Erweiterung um Multi-Dokumenten-Unterstützung** (Future Feature) |
|
|
| --- |
| *Design meets Code. Entwickelt mit Fokus auf Funktionalität und User Experience.* |
|
|
