README.md

---
title: Hugging Science Feedback API
emoji: 💬
colorFrom: gray
colorTo: gray
sdk: docker
pinned: false
---

# Hugging Science Feedback API

Minimal FastAPI service that accepts feedback submissions from huggingscience.co
and appends them to the [hugging-science/feedback](https://huggingface.co/datasets/hugging-science/feedback) dataset.

## Setup

Add a Space secret named `HF_TOKEN` with a write-scoped token for the `hugging-science` org.

## Endpoints

- `GET /` — health check
- `POST /submit` — submit a feedback entry

## Payload

```json
{
  "type": "dataset | model | challenge | feedback",
  "title": "Optional name or link",
  "description": "Required — what should be added and why?",
  "submitted_at": "2026-04-13T10:00:00Z",
  "source": "huggingscience.co"
}
```