🌊 DeepDive

YouTube → KI-Analyse → Zusammenfassung + MP3

Verwandle YouTube-Videos in professionelle, Blinkist-artige Zusammenfassungen mit KI-gestützter Analyse.

---

✨ Features

Feature	Beschreibung
🎬 YouTube Import	URL eingeben oder per integrierter Suche finden
🤖 KI-Analyse	DeepSeek-gestützte Zusammenfassung mit Themenanalyse, Statistiken & Ausblick
📄 Export	PDF (mit Diagrammen) + HTML (mit interaktiven SVG-Grafiken)
🎵 MP3 + Player	Audio-Download + integrierter Inline-Player
🧠 Blinkist-Format	Problem → Lösung → Beispiel-Struktur
💬 Chat-Q&A	Stelle Folgefragen zum Video-Transkript
🔍 YouTube-Suche	Integrierte Suche (kein API-Key nötig)
🌙 Light/Dark Mode	Umschaltbares Theme
📱 PWA-ready	App-Icon auf dem Homescreen
📊 Bento Grid	Modulares Kachel-Layout
🔄 Sort/Filter	History mit Datum/Status
🏗️ 3 Microservices	Downloader, Analyzer, Web-UI (entkoppelt & skalierbar)

🚀 Quick Start

# Repository klonen
git clone https://github.com/Xyesca/deepdive.git
cd deepdive

# Konfiguration
cp .env.example .env
# → DEEPSEEK_API_KEY eintragen

# Mit Docker starten
docker compose up -d

# Im Browser öffnen
open http://localhost:5000

🏗️ Architektur

┌──────────────┐    ┌─────────────────┐    ┌──────────────┐
│  Downloader   │───▶│   Summarizer    │───▶│   Web-UI     │
│  :5001        │    │   :5002         │    │   :5000      │
│  yt-dlp       │    │   DeepSeek API  │    │   Flask/HTMX │
│  faster-whisper│   │   PDF/HTML Gen  │    │   SSE Live   │
└──────────────┘    └─────────────────┘    └──────────────┘
                          │
                          ▼
                    ┌──────────────┐
                    │   SQLite     │
                    │   Datenbank  │
                    └──────────────┘

🛠️ Tech Stack

Komponente	Technologie
Backend	Python 3.11+, Flask
Frontend	HTMX, Tailwind CSS, Vanilla JS
KI	DeepSeek API (OpenAI-kompatibel)
Transkription	faster-whisper (lokal, GPU-frei)
Download	yt-dlp
PDF	WeasyPrint + SVG-Diagramme
Datenbank	SQLite
Container	Docker + Docker Compose
Monitoring	Sentry
CI/CD	GitHub Actions (self-hosted)

⚙️ Konfiguration

Alle Einstellungen über Umgebungsvariablen (.env):

# Erforderlich
DEEPSEEK_API_KEY=sk-...

# Optional
SENTRY_DSN=https://...@o....ingest.us.sentry.io/...
DEEPDIVE_PORT=5000

📦 Projektstruktur

deepdive/
├── service-web/           # Web-UI + API Gateway
│   ├── Dockerfile
│   └── ...
├── service-downloader/    # YouTube Download + Transkription
│   ├── Dockerfile
│   └── ...
├── service-summarizer/    # KI-Analyse + Exporte
│   ├── Dockerfile
│   └── ...
├── shared/                # Gemeinsame Bibliotheken
├── tests/
│   ├── test_api.py
│   └── test_ui.py
├── docker-compose.yml
├── Dockerfile
└── requirements.txt

📋 Tests

# API-Tests
python3 -m pytest tests/test_api.py -v

# UI-Tests (Playwright)
python3 tests/test_ui.py

# Alle Tests
python3 -m pytest tests/ -v

🤝 Beitragen

PRs willkommen! Für größere Änderungen bitte vorher ein Issue eröffnen.

📄 Lizenz

MIT — siehe LICENSE.

---

Entwickelt von Xavier Escalante Castellar

LinkedIn • GitHub