danialkhilji/HomeOS

HomeOS is a smart family dashboard designed to simplify household management by bringing chores, grocery lists, reminders, and useful information into one shared touchscreen interface.

55

stars

168

commits

Python

primary language

Aug 26, 2026

updated

dashboard
docker
fastapi
household
household-management
open-source
prayer-times
prayer-times-app
python
react
self-hosted
smart-home
smarthome
touchscreen
typescript

README

HomeOS

A self-hosted family operating system for a kitchen touchscreen. Manages household tasks, shopping lists, notes, prayer times, and birthdays from a single shared display.

Screenshots

Dashboard Calendar

Tasks Shopping

Settings

Tech Stack

  • Frontend: React, TypeScript, Vite, Tailwind CSS
  • Backend: Python 3.12, FastAPI, SQLAlchemy, SQLite
  • Infrastructure: Docker, Docker Compose
  • Target Device: Linux Mini PC + touchscreen display

Quick Start

git clone https://github.com/YOUR_USERNAME/HomeOS.git
cd HomeOS
cp .env.example .env
docker compose up --build

Documentation

License

MIT

Contributors

danialkhilji

168 commits

danialkhilji/HomeOS

HomeOS is a smart family dashboard designed to simplify household management by bringing chores, grocery lists, reminders, and useful information into one shared touchscreen interface.

55

stars

168

commits

Python

primary language

Aug 26, 2026

updated

dashboard
docker
fastapi
household
household-management
open-source
prayer-times
prayer-times-app
python
react
self-hosted
smart-home
smarthome
touchscreen
typescript

README

HomeOS

A self-hosted family operating system for a kitchen touchscreen. Manages household tasks, shopping lists, notes, prayer times, and birthdays from a single shared display.

Screenshots

Dashboard Calendar

Tasks Shopping

Settings

Tech Stack

  • Frontend: React, TypeScript, Vite, Tailwind CSS
  • Backend: Python 3.12, FastAPI, SQLAlchemy, SQLite
  • Infrastructure: Docker, Docker Compose
  • Target Device: Linux Mini PC + touchscreen display

Quick Start

git clone https://github.com/YOUR_USERNAME/HomeOS.git
cd HomeOS
cp .env.example .env
docker compose up --build

Documentation

License

MIT

Contributors

danialkhilji

168 commits

Languages

Python

47.9%

TypeScript

47.7%

CSS

3.0%