azoth

Azoth est une solution d'analytics web open-source et auto-hébergée, conçue pour les sites soucieux de la vie privée. Elle fonctionne entièrement sur Cloudflare Workers conjugué à Cloudflare Analytics Engine, éliminant tout besoin de services externes ou de scripts tiers. ### Fonctionnalités clés - **Suivi sans cookies** – Le tracker côté client ne pèse que ~1,4 Ko (≈0,6 Ko compressé) et rapporte les pages vues via l'API `sendBeacon`, garantissant qu'aucun cookie ni donnée personnelle n'est stocké. - **Respect de la vie privée** – Aucune donnée personnelle identifiable n'est collectée, et le système ne repose sur aucune infrastructure tierce, ce qui en fait une solide alternative à Google Analytics pour des déploiements conformes au RGPD. - **Auto-hébergement sur Cloudflare** – Déploie deux Workers : un pour le point de terminaison du tracker et un pour le dashboard React, tous deux alimentés par Cloudflare Analytics Engine pour un stockage rapide et évolutif. - **Dashboard React** – Une interface moderne qui interroge Analytics Engine afin d'afficher les statistiques de pages vues, les référents, les décomptes par appareil, et plus encore. - **Déploiement piloté par CLI** – La CLI `azoth` (construite avec Bun) vous guide à travers l'authentification Cloudflare, le patchage de configuration, la gestion des secrets (`AUTH_SECRET`, `CF_API_TOKEN`) et le déploiement en une seule commande (`bunx azoth install`). - **Outils de diagnostic** – `azoth doctor` exécute des vérifications en lecture seule, `azoth status` affiche l'état actuel du déploiement, et un mode `--dry-run` prévisualise les modifications sans les appliquer. - **Outils développeur** – Comprend le linting (Biome), la vérification des types (TypeScript) et les scripts de test à travers les workspaces, tous exécutables via Bun. ### Démarrage rapide ```bash bun install bunx azoth install ``` L'installateur va : 1. Vérifier votre connexion Cloudflare. 2. Patch `wrangler.toml` avec votre ID de compte. 3. Définir les secrets requis. 4. Déployer les deux Workers. 5. Effectuer un test de santé et afficher le snippet d'intégration pour votre site. Commandes supplémentaires : - `bunx azoth doctor` – diagnostics pré-déploiement (supporte `--json`). - `bunx azoth status` – afficher les infos du compte, des workers, des secrets et du dernier déploiement. - `bunx azoth install --yes` – mode non interactif. - `bunx azoth install --dry-run` – prévisualiser les modifications. ### Stack technique - **Runtime** : Bun (v1.3.14) – runtime JavaScript tout-en-un rapide. - **Plateforme** : Cloudflare Workers + Analytics Engine. - **Frontend** : React pour le dashboard. - **CLI** : Construite avec Bun, exploitant l'API Cloudflare pour l'automatisation. ### Licence Azoth est publié sous la licence MIT (© 2026 Ediz Yurdakul). Ce projet convient aux développeurs et propriétaires de sites qui recherchent une solution d'analytics légère et respectueuse de la vie privée qu'ils peuvent héberger et contrôler intégralement sur le réseau periphérique de Cloudflare.