| # Changelog |
|
|
| All notable changes to this project will be documented in this file. |
|
|
| ## [1.0.0] - 2026-04-24 |
|
|
| ### 🎉 Initial Release |
|
|
| #### Features |
|
|
| - **Self-hosted n8n** — Runs the latest n8n on HuggingFace Spaces Docker using SQLite (no external DB required). |
| - **Persistent Backup** — Automatically syncs the entire n8n workspace (workflows, credentials, database) to a private HF Dataset. |
| - **Cloudflare Transparent Proxy** — Built-in fix to bypass platform network blocks for Telegram, WhatsApp-related APIs, Google integrations, Discord, and other outbound services. |
| - **Automatic Cloudflare Worker provisioning** — Hugging8n can now create or update its outbound proxy automatically from `CLOUDFLARE_WORKERS_TOKEN`, matching HuggingClaw's auto-setup flow. |
| - **Google node coverage widened** — Worker defaults now cover Google API families more broadly so Sheets, Drive, Gmail, OAuth, and related nodes work without manual domain tuning. |
| - **Premium Dashboard** — Beautiful web interface at `/` for real-time uptime monitoring and sync health tracking. |
| - **Built-in Keep-Alive** — Integrated UptimeRobot setup tool directly from the dashboard to prevent free HF Spaces from sleeping. |
| - **Native Security** — Optimized for n8n v2 native user management with hardened file permissions (`umask 0077`). |
| - **Safe Persistence** — Uses atomic SQLite backups to ensure data integrity during periodic syncs. |
| - **Auto-Restore** — Seamlessly pulls the latest state from your HF Dataset on every startup. |
| - **Graceful Shutdown** — Ensures a final backup pass is completed on `SIGTERM` / `SIGINT` before the container exits. |
|
|
| #### Architecture |
|
|
| - `Dockerfile` — Optimized build on `node:22-slim` including all n8n and sync dependencies. |
| - `start.sh` — Orchestrates startup, validates environment, and manages service lifecycle. |
| - `health-server.js` — High-performance namespace proxy and dashboard server. |
| - `cloudflare-proxy.js` — Transparently intercepts and routes blocked traffic via Cloudflare Workers. |
| - `n8n-sync.py` — Robust background sync engine using the `huggingface_hub` API. |
| - `start.sh` — Configures environment, restores backup, and launches background sync loop. |
|
|
| --- |
| *Made with ❤️ by [@somratpro](https://github.com/somratpro)* |
|
|
