---
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

```bash
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