Alexa Local Integration

Local-first Echo device control — bypassing Amazon's cloud APIs entirely

🔩 Status: Active development — AirPlay TTS streaming operational, multi-protocol discovery working, Bluetooth and WHA in research phase

Backend

  • Python 3.12 / FastAPI
  • Uvicorn ASGI server
  • edge-tts (local TTS generation)
  • pyatv (AirPlay protocol)

Discovery

  • nmap network scanning
  • zeroconf / mDNS
  • SSDP (UPnP)
  • ARP table inspection

Frontend

  • Jinja2 templates
  • jQuery + Axios
  • ES6 modules

Infrastructure

  • Docker Compose
  • nginx reverse proxy
  • Host networking (multicast)
  • Mobius proxy integration

Transport Strategy (Tiered)


Documentation

Device Inventory

Network scan results, open ports, MAC addresses, and device classification for all discovered Echo devices

Active Discovery

Local Protocols Research

SSDP, mDNS, AirPlay, WHA protocol analysis and exploitation findings

Research Protocols

Port Mappings

External/internal port assignments for all Docker services

Infrastructure

Project History

Chronological log of implementation progress, architectural decisions, and completed milestones (internal only)

History

Port Allocation

Service Port Purpose
FastAPI (internal) 5055 Backend API
nginx HTTP 8055 Public web UI
nginx HTTPS 8455 HTTPS access
mobius.alexa 80 (via proxy) Reverse proxy route