gitwtfhub

wtf is harbor-index?

harbor-framework/harbor-index — explained in plain English

Analysis updated 2026-05-18

19PythonAudience · researcherComplexity · 3/5Setup · moderate

TL;DR

An 80-task benchmark for evaluating AI coding agents, with a public leaderboard where anyone can submit their own agent's results.

Mindmap

mindmap
  root((repo))
    What it does
      80 task agent benchmark
      Public leaderboard
    Process
      Run benchmark locally
      Upload results
      Submit PR to leaderboard
    Tech stack
      Python
      YAML config
    Audience
      AI agent researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Measure how well a specific AI agent and model combination performs on a curated set of coding tasks.

REASON 2

Compare your AI agent's performance against others on a public leaderboard.

REASON 3

Use the benchmark's reward-hacking safeguards as a reference when designing your own agent evaluations.

What's in the stack?

PythonYAML

How it stacks up

harbor-framework/harbor-index16nic/comfyui-agnes-ai6c696e68/gpt_signup_hybrid
Stars191919
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/52/54/5
Audienceresearchervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Requires API keys for multiple AI providers since part of the scoring uses an LLM-judge ensemble.

Wtf does this do

Harbor Index is a benchmark used to measure how well AI coding agents perform. It consists of 80 tasks that were narrowed down from a starting pool of more than 6,000 candidate tasks, filtered through repeated test runs, automatic detection of broken tasks, human review, and checks for what the readme calls "reward hacking," meaning attempts by an AI agent to score well without actually solving the task properly. The main purpose of this repository, based on the readme, is to support a public leaderboard where people can submit results from running their own AI agent against the benchmark and compare performance against others. To submit, someone runs the benchmark using a command line tool called harbor, specifying which AI agent and which underlying language model they want to test, along with API keys for several AI providers. Those provider API keys are needed because part of the scoring uses a panel of AI models acting as judges to evaluate a portion of the tasks, rather than a purely automated check. After running the benchmark, results are uploaded publicly, and the person submitting opens a pull request in a separate leaderboard repository, linking to their uploaded results. From there, automated checks validate the submission and maintainers review the underlying trajectories, meaning the recorded steps the AI agent actually took, before merging it in as a new row on the public leaderboard. The project also includes internal maintenance tooling, such as an automated process for cutting new versions and a documented policy for how long automated verification checks are allowed to run relative to the overall evaluation time budget. This repository is aimed at people building or evaluating AI coding agents, not general software developers.

Yoink these prompts

Prompt 1
Walk me through running the harbor benchmark against a specific agent and model.
Prompt 2
Explain how the LLM-judge ensemble scores tasks in this benchmark.
Prompt 3
Help me set up the API keys needed to submit results to the harbor-index leaderboard.
Prompt 4
What is the verifier timeout headroom policy and why does it matter for long-running tasks?

Frequently asked questions

wtf is harbor-index?

An 80-task benchmark for evaluating AI coding agents, with a public leaderboard where anyone can submit their own agent's results.

What language is harbor-index written in?

Mainly Python. The stack also includes Python, YAML.

How hard is harbor-index to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is harbor-index for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.