azoth

Azoth é uma solução de análise web de código aberto e auto-hospedada, projetada para sites preocupados com a privacidade. Ela funciona inteiramente em Cloudflare Workers juntamente com o Cloudflare Analytics Engine, eliminando a necessidade de quaisquer serviços externos ou scripts de terceiros. ### Principais Recursos - **Rastreamento sem cookies** – O rastreador do lado do cliente tem apenas ~1.4 KB (≈0.6 KB compactado) e relata visualizações de página via API `sendBeacon`, garantindo que nenhum cookie ou dado pessoal seja armazenado. - **Privacidade em primeiro lugar** – Nenhuma PII é coletada, e o sistema não depende de nenhuma infraestrutura de terceiros, tornando-o uma forte alternativa ao Google Analytics para implantações compatíveis com GDPR. - **Auto-hospedado no Cloudflare** – É implantado como dois Workers: um para o endpoint do rastreador e outro para o painel React, ambos suportados pelo Cloudflare Analytics Engine para armazenamento rápido e escalável. - **Painel React** – Uma UI moderna que consulta o Analytics Engine para exibir estatísticas de visualizações de página, referências, detalhamento de dispositivos e muito mais. - **Implantação via CLI** – O CLI `azoth` (construído com Bun) guia você pela autenticação do Cloudflare, aplicação de patches de configuração, gerenciamento de segredos (`AUTH_SECRET`, `CF_API_TOKEN`) e implantação em um único comando (`bunx azoth install`). - **Ferramentas de diagnóstico** – `azoth doctor` executa verificações somente leitura, `azoth status` mostra o estado atual da implantação, e um modo `--dry-run` pré-visualiza as alterações sem aplicá-las. - **Ferramentas para desenvolvedores** – Inclui linting (Biome), verificação de tipos (TypeScript) e scripts de teste em todos os workspaces, todos executáveis via Bun. ### Início Rápido ```bash bun install bunx azoth install ``` O instalador irá: 1. Verificar seu login no Cloudflare. 2. Aplicar patch em `wrangler.toml` com seu ID de conta. 3. Definir os segredos necessários. 4. Implantar ambos os Workers. 5. Realizar uma verificação de saúde e gerar o snippet de incorporação para seu site. Comandos adicionais: - `bunx azoth doctor` – diagnósticos pré-implantação (suporta `--json`). - `bunx azoth status` – visualizar conta, workers, segredos e informações da última implantação. - `bunx azoth install --yes` – modo não interativo. - `bunx azoth install --dry-run` – pré-visualizar alterações. ### Pilha Tecnológica - **Runtime**: Bun (v1.3.14) – runtime JavaScript rápido e completo. - **Plataforma**: Cloudflare Workers + Analytics Engine. - **Frontend**: React para o painel. - **CLI**: Construído com Bun, aproveitando a API do Cloudflare para automação. ### Licença Azoth é lançado sob a Licença MIT (© 2026 Ediz Yurdakul). Este projeto é adequado para desenvolvedores e proprietários de sites que precisam de uma solução de análise leve e que respeita a privacidade, que podem hospedar e controlar inteiramente na rede de borda do Cloudflare.