Hugging8N / README.md
somratpro's picture
refactor: optimize startup, improve security, and simplify n8n configuration for v2 compatibility
320e776
|
raw
history blame
2.15 kB
metadata
title: Hugging8n
emoji: ♾️
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7861
pinned: true
license: mit
secrets:
  - name: HF_TOKEN
    description: HuggingFace token with write access. Used for automatic backup.

♾️ Hugging8n

Self-hosted n8n workflow automation β€” free, no server needed. Hugging8n runs n8n on HuggingFace Spaces Docker, serving a premium dashboard at / and the n8n editor at /app/.

✨ Features

  • ⚑ Zero Config: Duplicate this Space, set HF_TOKEN, and you're ready.
  • πŸ’Ύ Persistent Backup: Workflows and credentials back up automatically to a private HF Dataset.
  • πŸ” Secure by Default: Uses n8n v2's built-in user management. No more insecure environment variables.
  • 🐳 Docker Native: Optimized for the free HF Spaces tier.
  • 🌐 Dashboard UI: Beautiful management interface at the root URL.
  • ⏰ Built-in Keep-Alive: Easily setup UptimeRobot from the dashboard.

πŸš€ Quick Start

Step 1: Duplicate this Space

Duplicate this Space

Step 2: Add Your HF_TOKEN

Add your HuggingFace token with write access to the Space Secrets. This enables automatic backup so your workflows aren't lost on restart.

Step 3: Set Up Auth

When the Space starts, visit the URL and click Open n8n Editor. On the first run, n8n will ask you to create an owner account. This is your primary login.

πŸ” Authentication

Hugging8n uses n8n's native user management.

  1. The first person to visit /app/ on a fresh install becomes the owner.
  2. If you are restoring from a backup, your existing user accounts will be active.

πŸ’Ύ Persistent Backup

Your data is synced to a private dataset named hugging8n-backup in your HF account.

πŸ—οΈ Architecture

  • / : Premium Dashboard (Status, Uptime, Keep-Alive setup)
  • /app/ : n8n Workflow Editor
  • /health : Health check endpoint

Made with ❀️ by @somratpro