README.md

metadata

title: Webhook Processing
emoji: 🌖
colorFrom: gray
colorTo: blue
sdk: gradio
sdk_version: 5.9.1
app_file: app.py
pinned: false

HuggingFace Webhook Processor

A Gradio Space that receives and processes HuggingFace Hub webhooks, storing them for later analysis.

Features

• ✅ Receives HuggingFace Hub webhooks via /webhooks/hub endpoint
• ✅ Filters webhooks by scope (repo and repo.content only)
• ✅ Stores webhook payloads in memory
• ✅ Automatically batches and saves to dataset every 100 messages
• ✅ Saves as efficient parquet files for easy querying
• ✅ Real-time status dashboard

Webhook Setup

Configure your HuggingFace Hub webhooks to point to:

https://[your-space-name].hf.space/webhooks/hub

Dataset Output

Webhooks are saved to: assafvayner/webhook-messages

Each batch is saved as a separate parquet file with:

• Timestamp
• Event type
• Scope
• Full JSON payload

Environment Variables

Requires HF_TOKEN with write access to the dataset repository.

API Endpoints

• POST /webhooks/hub - Receive webhooks
• GET /webhooks/health - Health check and stats

Local Development

python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows
pip install -r requirements.txt
export HF_TOKEN=your_token_here
python app.py

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference