README.md

---
title: Argilla Webhooks
emoji: 🦀
colorFrom: pink
colorTo: pink
sdk: gradio
sdk_version: 4.44.1
app_file: app.py
pinned: false
---

## Description

This space is a basic server webhooks example to show how to set up webhook listeners using the argilla SDK.

The application defines three webhook listeners for the following events:

- Record events: `record.deleted`, `record.completed`
- Dataset events: `dataset.created`, `dataset.updated`, `dataset.deleted`, `dataset.published`
- Response events: `response.created`, `response.updated`
        
The events are stored in a queue and displayed in the JSON component and the incoming events is updated every second.

This application is just a demonstration of how to use the Argilla webhook listeners. You can visit the 
[Argilla documentation](https://docs.argilla.io/dev/how_to_guides/webhooks) for more information.

## Running the app

First create an HF space running the argilla server. Be sure argilla spaces is public. 

Once the server is up and running, you must define the following environment variables:

```bash
export ARGILLA_API_KEY=<your_api_key>
export ARGILLA_API_URL=<your_api_url>
```

Now, you can run the app just running the following command:

```bash
python app.py
```

## Testing the app

Open the gradio application on a browser (http://localhost:7860). You can see incoming events from the argilla server.