azoth

Azoth es una solución de análisis web de código abierto y autoalojada, diseñada para sitios conscientes de la privacidad. Funciona completamente sobre Cloudflare Workers junto con el Motor de Análisis de Cloudflare, eliminando la necesidad de servicios externos o scripts de terceros. ### Funcionalidades clave - **Seguimiento sin cookies** – El tracker del lado del cliente tiene solo ~1.4 KB (≈0.6 KB comprimido) y reporta vistas de página mediante la API `sendBeacon`, garantizando que no se almacenen cookies ni datos personales. - **Privacidad desde el diseño** – No se recopila información personal identificable (PII), y el sistema no depende de infraestructura de terceros, lo que lo convierte en una alternativa sólida a Google Analytics para despliegues conformes con el GDPR. - **Autoalojado en Cloudflare** – Se implementa como dos Workers: uno para el endpoint del tracker y otro para el dashboard de React, respaldados por el Motor de Análisis de Cloudflare para un almacenamiento rápido y escalable. - **Dashboard en React** – Una interfaz moderna que consulta el Motor de Análisis para mostrar estadísticas de vistas de página, referenciales, desglose por dispositivos, entre otros. - **Despliegue basado en CLI** – La CLI `azoth` (construida con Bun) guía al usuario a través de la autenticación en Cloudflare, configuración, gestión de secretos (`AUTH_SECRET`, `CF_API_TOKEN`) y despliegue en un solo comando (`bunx azoth install`). - **Herramientas diagnósticas** – `azoth doctor` ejecuta verificaciones de solo lectura, `azoth status` muestra el estado actual del despliegue, y el modo `--dry-run` permite previsualizar cambios sin aplicarlos. - **Herramientas para desarrolladores** – Incluye linting (Biome), comprobación de tipos (TypeScript) y scripts de prueba en todos los workspaces, ejecutables vía Bun. ### Inicio rápido ```bash bun install bunx azoth install ``` El instalador realizará: 1. Verificará tu inicio de sesión en Cloudflare. 2. Actualizará `wrangler.toml` con tu ID de cuenta. 3. Configurará los secretos requeridos. 4. Desplegará ambos Workers. 5. Ejecutará una verificación de salud e imprimirá el fragmento de embed para tu sitio. Comandos adicionales: - `bunx azoth doctor` – diagnósticos previos al despliegue (soporta `--json`). - `bunx azoth status` – visualiza información de cuenta, workers, secretos y último despliegue. - `bunx azoth install --yes` – modo no interactivo. - `bunx azoth install --dry-run` – previsualiza cambios. ### Stack técnico - **Runtime**: Bun (v1.3.14) – runtime JavaScript todo en uno de alta velocidad. - **Plataforma**: Cloudflare Workers + Analytics Engine. - **Frontend**: React para el dashboard. - **CLI**: Construida con Bun, aprovechando la API de Cloudflare para automatización. ### Licencia Azoth se publica bajo la Licencia MIT (© 2026 Ediz Yurdakul). Este proyecto es adecuado para desarrolladores y propietarios de sitios que necesitan una solución de análisis ligera, respetuosa con la privacidad, que puedan alojar y controlar completamente en la red perimetral de Cloudflare.