v1.3.0 jetzt verfügbar

CatchRadar

Die selbst-gehostete Beißindex-Prognose für anspruchsvolle Angler. Präzise Vorhersagen für Zander, Hecht, Barsch und Wels – mit maximalem Datenschutz.

METEOROLOGISCH • PRÄZISE • MULTIPLIKATIV
Docker installieren 🎣 Zum Dashboard
Warum CatchRadar?

Gebaut für Angler,
die ihre Daten schätzen

CatchRadar kombiniert modernste Wetterdaten mit einem streng multiplikativen Berechnungsmodell – selbst-gehostet auf deiner eigenen Infrastruktur.

Async Python/FastAPI Backend

Hochperformantes asynchrones Backend mit Python und FastAPI. Echtzeit-Prognosen in Millisekunden, optimiert für tausende parallele API-Anfragen ohne Verzögerung.

100% Privacy & Self-Hosted

Deine Geheim-Hotspots bleiben geheim. Läuft komplett lokal via Docker/Podman – keine Cloud, keine Tracker, keine Drittanbieter. Alle Wetterdaten werden lokal verarbeitet.

Multiplikatives Berechnungsmodell

Statt simpler Durchschnitte: Unser streng multiplikatives Modell gewichtet Luftdrucktrends, Mondphasen, Windrichtung und Temperatur artgerecht für Zander, Hecht, Barsch und Wels.

Modulare REST API

Nahtlose Smart-Home-Integration via REST API. Binde CatchRadar in Home Assistant, Node-RED oder deine eigene Angel-App ein – mit vollständiger OpenAPI-Dokumentation.

Algorithmus

Der CatchRadar Algorithmus

Ein Blick unter die Haube: So berechnet das Modell den Beißindex für deine Zielfische in Echtzeit – mit einem strikt multiplikativen Modell, bei dem jeder Faktor zählt.

CatchRadar v1.3.0 · running
Z
Zander
88%
Excellent
Luftdruck Δ1.08×
Windrichtung1.12×
Wassertemp.0.94×
Mondphase1.05×
= 1.08 × 1.12 × 0.94 × 1.05
H
Hecht
71%
Gut
Luftdruck Δ0.98×
Windrichtung1.04×
Wassertemp.0.87×
Mondphase1.02×
= 0.98 × 1.04 × 0.87 × 1.02
B
Barsch
63%
Moderat
Luftdruck Δ0.92×
Windrichtung1.01×
Wassertemp.0.95×
Mondphase0.89×
= 0.92 × 1.01 × 0.95 × 0.89
W
Wels
45%
Schwach
Luftdruck Δ0.85×
Windrichtung0.93×
Wassertemp.0.78×
Mondphase0.91×
= 0.85 × 0.93 × 0.78 × 0.91

Strikt multiplikatives Modell

Jeder Zielfisch hat art-spezifische Gewichtungen. Die Faktoren Luftdruckänderung, Windrichtung, Wassertemperatur und Mondphase werden als Multiplikatoren (0.0–1.5×) berechnet und miteinander multipliziert. Das Ergebnis ist ein Beissindex zwischen 0% und 100% – keine simplen Durchschnittswerte, sondern ein echtes Produkt unabhängiger Umweltfaktoren.

Bfinal = fpressure · fwind · ftemp · fmoon · 100
Vergleich

CatchRadar vs. Klassische Apps

Warum ein selbst-gehostetes Prognose-Tool den herkömmlichen Angel-Apps überlegen ist.

Feature
CatchRadar
Klassische Apps
Werbefrei
Keine Werbung, kein Tracking
Voll mit Ads & In-App-Käufen
Hotspot-Datenschutz
Daten bleiben lokal
Daten werden an Server gesendet
Self-Hosting
Docker/Podman · Volle Kontrolle
Nicht möglich / Cloud-only
Modell
Streng multiplikativ
Simple Durchschnittswerte
API-Integration
REST API · Home Assistant Ready
Keine / Proprietär
Installation

In 2 Minuten eingerichtet

Klone das Repository und starte CatchRadar mit einem einzigen Befehl. Läuft auf jedem Linux-Server, NAS oder Raspberry Pi.

Terminal · Docker Setup
# Repository klonen
$ git clone https://github.com/yourname/catchradar.git
# In das Verzeichnis wechseln
$ cd catchradar
# Container starten (Docker Compose)
$ docker-compose up -d
█
[+] Running 3/3
✔ Container catchradar-api    Started
✔ Container catchradar-db     Healthy
✔ Container catchradar-web    Started
Terminal · API Request
# Beißindex für Ziel-Fisch abrufen
$ curl -X GET \
"http://localhost:8000/api/v1/prognosis/zander"
█
{
"fish": "zander",
"bite_index": 88,
"rating": "excellent",
"pressure_trend": "rising",
"moon_phase": "waxing_gibbous",
"timestamp": "2026-07-09T14:30:00Z"
}
Home Assistant
Node-RED
OpenAPI 3.0
Docker & Podman
API-Referenz

API & Dokumentation

CatchRadar v1.3.0 stellt eine schlanke FastAPI-REST-API bereit. Hier findest du alle relevanten Endpunkte und das Antwort-Schema.

GET /api/v1/prognosis

Berechnet den Multi-Faktor-Beissindex für einen Zielfisch an einem bestimmten Standort. Nutzt das strikt multiplikative Modell (v1.3.0).

Query-Parameter

Parameter Typ Erforderlich Beschreibung
target string ja Zielfisch: zander, hecht, barsch, wels
lat float ja Breitengrad (z. B. 52.5200)
lon float ja Längengrad (z. B. 13.4050)

Beispiel-Request

curl -X GET "http://localhost:8000/api/v1/prognosis?target=zander&lat=52.5200&lon=13.4050"

Response (200 OK) · JSON

{
"status": "ok",
"version": "1.3.0",
"prognosis": {
"target": "zander",
"bite_index": 88,
"rating": "excellent",
"factors": {
"pressure_trend": { "value": "rising", "multiplier": 1.08 },
"wind_direction": { "value": "SW", "multiplier": 1.12 },
"water_temperature": { "value": 18.2, "multiplier": 0.94 },
"moon_phase": { "phase": "waxing_gibbous", "multiplier": 1.05 }
},
"model": "strict_multiplicative_v1.3",
"coordinates": { "lat": 52.52, "lon": 13.405 },
"timestamp": "2026-07-09T14:30:00.000Z"
}
}
200 Erfolgreich – Prognose berechnet
422 Ungültiger target-Parameter
500 Wetterdaten-Quelle nicht erreichbar
GET /api/v1/health

Health-Check-Endpunkt. Gibt Status der Wetterdaten-Quelle und Cache-Frische zurück.

{ "status": "healthy", "cache_age_s": 42 }
http://localhost:8000/api/v1/health
GET /docs

Interaktive OpenAPI-Dokumentation (Swagger UI). Alle Endpunkte live testen.

http://localhost:8000/docs ← Swagger UI (automatisch von FastAPI aus dem Python-Quellcode generiert)