pantau-alexaVoice-control your home — from your own server

Alexa Smart Home backend that connects your TV, roller blinds, and heating over a self-hosted FastAPI server. No third-party cloud required for the actual device control.

Get Started

Architecture

Modules

📺

TV via Harmony Hub

"Alexa, switch to ZDF" — activates the TV activity and tunes the channel via Logitech Harmony Hub over WebSocket. Each channel is its own Alexa endpoint.

🪟

Roller Blinds via HomeKit

"Alexa, open the blinds in the kitchen" — drives HomeKit accessories via RangeController (0–100%). Open, close, or set an exact position by voice.

🌡️

Heating via FRITZ!Box

"Alexa, set the living room heating to 22 degrees" — controls AVM FRITZ!DECT smart thermostats through the fritzctl library with built-in safety limits.

🔐

Self-hosted OAuth2 IdP

Your home server is its own OAuth2 Authorization Server with PKCE. Credentials never leave your network. JWT access tokens are short-lived; refresh tokens rotate on every use.

🏗️

Hexagonal Architecture

Domain → Commands → Ports ← Adapters. Use-cases are testable without hardware. Adding a new device or Alexa capability requires config or a single new file — not a rewrite.

⚙️

Config-driven Device Registry

All devices and channels live in devices.yaml. Adding a new TV channel or thermostat is a one-line YAML change — zero code required.