What is SelenaCore?

SelenaCore is an open-source smart home hub designed to run on Raspberry Pi 4/5 and any Linux-based single-board computers. The project's standout feature is its completely autonomous operation, free from clouds, subscriptions, and external dependencies.

Technology Stack

Backend: Python 3.11+, FastAPI 0.115+

Frontend: TypeScript, Vite, HTML/CSS (PWA)

Containerization: Docker + Docker Compose

Database: SQLAlchemy

Voice Assistant: Whisper.cpp + Piper (fully offline)

Security: AES-256-GCM encryption, SHA256 verification

Architecture

The system is built upon three core principles:

Immutable Core: Core files are protected by SHA256 checksums. Any unauthorized modification is immediately detected.

Isolated Modules: All modules communicate via HTTP on localhost:7070. Each module operates within a Docker sandbox.

Integrity Agent: A background service that continuously monitors the system's state.

Key Features

Voice Assistant: Fully offline capabilities including wake-word detection, speech-to-text (STT), and text-to-speech (TTS).

Device Management: A registry built on SQLAlchemy with an event-driven architecture.

Modular System: An extensible plugin architecture utilizing Docker sandboxing.

PWA Interface: A progressive web application accessible from any device within the local network.

Developer SDK: Tools for creating modules using decorators and a dedicated CLI utility.

Security

Token Encryption: AES-256-GCM encryption for secure data handling.

Local Processing: Biometric data is processed strictly on-device.

Rate Limiting: Capped at 120 requests per minute to prevent abuse.

Integrity Checks: Periodic SHA256 verification of core files.

Sandboxing: Modules are strictly isolated from the core file system.