---
title: "FilBench Leaderboard"
emoji: 🥇
colorFrom: green
colorTo: indigo
sdk: gradio
app_file: app.py
pinned: true
license: apache-2.0
short_description: An Open LLM Leaderboard for Filipino
sdk_version: 5.19.0
---

# HF Leaderboard Backend

This is a fork of the [leaderboard demo from HuggingFace](https://huggingface.co/demo-leaderboard-backend) with some additional scripts for parsing the results from our evaluation runs.

## Set-up and installation

To start development, clone the repository and install the dependencies.
This assumes you have `uv` installed.
Make sure to also install the pre-commit hooks so that formatting is uniform across the codebase.

```sh
git clone git@github.com:filbench/hf-leaderboard-backend.git
cd hf-leaderboard-backend
uv sync
source .venv/bin/activate
pre-commit install
```

To view the leaderboard **locally**, then run the following command:

```sh
gradio app.py
```

This will launch the leaderboard (by default in `localhost:7860`) in hot-reload mode, so you can see the changes as you edit the source code.

## Updating the HuggingFace Space

All development should happen in this GitHub remote.
If you want to update the HuggingFace space, you should add a remote pointing to the space and push all changes.
You might need to [add your machine's SSH key](https://huggingface.co/settings/keys) to HuggingFace.

```sh
git remote add hf git@hf.co:spaces/UD-Filipino/filbench-leaderboard
git push hf main
```