---
title: Hugging Face Harbor Visualiser
emoji: 🤗
colorFrom: yellow
colorTo: red
sdk: docker
app_port: 7860
pinned: false
license: apache-2.0
short_description: Browse Harbor task specs from HF Hub, GitHub, or local
---

# 🤗 Hugging Face Harbor Visualiser

A FastAPI Space for browsing [Harbor](https://www.harborframework.com/) task spec directories — the dataset format used by Harbor for agent evaluation + RL environments.

Drop in a Hugging Face dataset id, a GitHub repo, or a local Harbor dataset directory; the viewer renders every task's metadata, instruction, oracle patch, test script, and Dockerfile side-by-side. Large datasets (2k+ tasks) list and open instantly — task ids come from a shallow Hub listing and only the opened task's files are fetched, so nothing is bulk-downloaded.

## Use it

Open the Space and paste a dataset URI in the input box.

Prefill via URL param:
```
https://huggingface.co/spaces/AdithyaSK/harbor-visualiser?dataset=<owner>/<dataset>
```

**Inputs accepted:**

| Form | Source |
|---|---|
| `owner/name` | HF Hub dataset (default) |
| `hf://owner/name` | HF Hub (explicit) |
| `hf://owner/name@<rev>` | HF Hub revision pin |
| `gh://owner/repo` | GitHub repo |
| `gh://owner/repo@<ref>` | GitHub at branch / tag / SHA |
| `https://github.com/owner/repo` | Full GitHub URL |

## Run locally

```bash
pip install -r requirements.txt
uvicorn app:app --port 7860
# → http://127.0.0.1:7860
```

## What it shows per task

| Tab | Source file |
|---|---|
| Overview | parsed `task.toml` ([task], [metadata]) + `[metadata.repo2env]` if present |
| Instruction | `instruction.md` |
| Patch (oracle) | `solution/patch.diff` |
| `test.sh` | `tests/test.sh` |
| Dockerfile | `environment/Dockerfile` |
| `solve.sh` | `solution/solve.sh` (when present) |
| Raw `task.toml` | full file |

## Dataset layout it expects (Harbor's standard)

Either of these:

```
# Layout A — flat (what Repo2RLEnv emits + most git repos use)
<dataset-root>/
├── <task-id>/
│   ├── task.toml
│   ├── instruction.md
│   ├── solution/
│   │   ├── patch.diff
│   │   └── solve.sh
│   ├── tests/test.sh
│   └── environment/Dockerfile
└── <task-id>/...

# Layout B — nested (what `repo2rlenv push` stages on the Hub)
<dataset-root>/
├── registry.json
├── README.md
└── tasks/
    └── <task-id>/
        └── ... (same as Layout A)
```

## Stack

- [FastAPI](https://fastapi.tiangolo.com/) + [uvicorn](https://www.uvicorn.org/) — server
- Vanilla-JS single-page UI (hash-routed) with a Hugging Face theme
- [huggingface_hub](https://github.com/huggingface/huggingface_hub) — Hub listing + per-task download
- `git` (system binary) — GitHub clone
- Python stdlib `tomllib` — task.toml parsing