Guardian platform

Guardian is a multi-tenant parental-control server. This repository contains the Flask web application, WebSocket hub, background worker, browser extension, and container packaging.

Related repositories

• agent-common — shared protocol and policy logic
• agent-linux
• agent-windows
• agent-android
• docs
• translations
• versions — compiled release feed

Quick start

cp .env.example .env
docker compose up -d

Sign in at the dashboard with admin / admin, then change the password under Settings.

Development

./scripts/setup-dev.sh
cd server
TESTING=True ./.venv/bin/python -m pytest -q -n auto

UI strings are maintained in the translations repository. Product pull requests which add keys must link the translations pull request:

Translations: #42

Version 1.0

Version 1.0 is a breaking repository and release-system change. Agent versions, repositories, and artifact URLs come only from the compiled versions feed. See the migration guide.

License

MIT — see LICENSE.