Lumen · light

Browser-basierter, selbst-gehosteter RAW-Foto-Editor — eine schlanke, abofreie Lightroom-Alternative für Hobby-Fotografen. Ohne Software-Installation, ohne Cloud-Pflicht.

🔗 Live-Demo · Features · Schnellstart · Selfhost

Selfhost auf einem 4-GB-VPS · Open-Source-Stack · DSGVO-konform out-of-the-box.

Was Lumen kann

• RAW direkt im Browser oeffnen: CR2, CR3, NEF, ARW, DNG, RAF, RW2, ORF — via libraw-wasm in einem Web-Worker.
• 12 globale Slider (Belichtung, Kontrast, Lichter, Tiefen, Weiss, Schwarz, Temperatur, Toenung, Dynamik, Saettigung, Schaerfen, Rauschen) plus HSL-Mischer (8 Farbkanaele × 3 Achsen) und Spline-Tonkurve (2-8 Stuetzpunkte mit Monotone-Hermite).
• Bis zu 8 lokale Anpassungen pro Bild: 4 lineare Verlaufsfilter + 4 elliptische Radialmasken, jede mit Belichtung/Kontrast/Saettigung/Temperatur.
• Auto-Funktionen: Auto-Tone (Histogramm-Analyse), Auto-WB (Gray-World), Auto-Begradigen (Sobel + Hough), Smart-Preset-Vorschlag (EXIF-Brennweite + optionale Face-Detection ueber TensorFlow.js).
• Lens-Profile fuer 18 verbreitete Kamera+Objektiv-Kombinationen (Verzeichnung + Vignette automatisch).
• Vorher/Nachher-Vergleich: Bypass-halten oder Compare-Split.
• Export als JPEG oder PNG, Quality- und Width-Slider.
• Preset-Marketplace: User koennen Presets oeffentlich teilen, andere wenden sie auf eigene Bilder an oder forken in die eigene Bibliothek. Reporting + Auto-Hide bei Missbrauch.

Lumen vs. Lightroom

Lumen ersetzt nicht jeden Profi-Workflow — aber für RAW-Entwicklung ohne Abo und ohne Cloud-Zwang deckt es die wichtigsten Schritte ab.

	Lumen · light	Adobe Lightroom
Preis	Kostenlos, selbst-hostbar	Abo ab ~12 €/Monat
Plattform	Browser (WebGL2)	Desktop + Cloud-App
Deine Daten	Bleiben bei dir	Adobe Creative Cloud
RAW im Browser	Ja	Nein (Desktop)
Lokale Masken	Linear + Radial	Umfangreich (inkl. KI)
Ohne Abo / offline	Ja	Nein

Stack

• Backend: FastAPI · async SQLAlchemy 2 + asyncpg · Alembic · Pydantic 2 · slowapi (Redis-Backend in Production) · boto3
• Frontend: React 19 · Vite 8 · TypeScript strict · Tailwind 4 · Zustand 5 · WebGL2 (Single-Pass-Fragment-Shader mit Uniform-Arrays fuer Multi-Mask)
• Auth: Keycloak (OIDC, Realm lumen, JWT RS256-Whitelist)
• Storage: Postgres 16 · Garage S3 (Pre-Signed-URLs, Pixel laufen NICHT durch FastAPI)
• Deployment: Docker Compose · Caddy als Reverse-Proxy (CSP + HSTS + Permissions-Policy)
• ML (optional): TensorFlow.js Mediapipe-Face-Detection — Lazy-Load, Default-aus, ausdrueckliche User-Einwilligung

Schnellstart (lokale Entwicklung)

# 1. Postgres + Keycloak + Garage-S3 hochfahren
docker compose -f deployment/docker-compose.dev.yml up -d
until curl -fs http://localhost:19000/health/ready >/dev/null; do sleep 2; done

# 2. Backend-Migration + Server
cd backend
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt -r requirements-dev.txt
DATABASE_URL="postgresql+asyncpg://lumen:lumen@localhost:5433/lumen" \
  .venv/bin/alembic upgrade head

DATABASE_URL="postgresql+asyncpg://lumen:lumen@localhost:5433/lumen" \
KEYCLOAK_ISSUER="http://localhost:18080/realms/lumen" \
KEYCLOAK_AUDIENCE="lumen-api" \
GARAGE_S3_ENDPOINT="http://localhost:9000" GARAGE_S3_REGION="garage" \
GARAGE_S3_BUCKET="lumen-images" \
GARAGE_S3_ACCESS_KEY_ID="GKde7000000000000000000001" \
GARAGE_S3_SECRET_ACCESS_KEY="de70000000000000000000000000000000000000000000000000000000000001" \
CORS_ORIGIN="http://localhost:5173" \
.venv/bin/uvicorn app.main:app --host 127.0.0.1 --port 8000

# 3. Frontend (anderes Terminal)
cd frontend
cp .env.example .env.local   # ggf. anpassen
pnpm install
pnpm dev                     # http://localhost:5173

Test-User in Keycloak via Admin-API anlegen — siehe CLAUDE.md Abschnitt „Test-User in Keycloak".

Tests

# Backend (testcontainers fuer PG + Garage + Keycloak — Docker muss laufen)
cd backend && .venv/bin/pytest -q
# Aktuell: 99 Tests, ~50 s nach Image-Cache.

# Frontend Unit + Component
cd frontend && pnpm test
# Aktuell: 333 Tests in 40 Files, ~7 s.

# E2E (Stack muss komplett laufen)
cd frontend && pnpm exec playwright test

# Statisch
cd frontend && pnpm lint && pnpm build && pnpm exec tsc -b --noEmit

This is the beginning of the README. Read the rest at the original. Read the full README ↗