git404hub

what is wandr fr?

perplexityai/wandr — explained in plain English

Analysis updated 2026-05-18

246PythonAudience · researcherComplexity · 5/5Setup · hard

tl;dr

A research benchmark from Perplexity AI that tests how well AI systems handle broad, evidence backed information gathering tasks.

vibe map

mindmap
  root((wandr))
    What it does
      Wide deep research benchmark
      Scores AI research quality
      Cross provider testing
    Tech stack
      Python
      Docker
      Harbor framework
    Use cases
      Evaluate AI research agents
      Compare provider performance
    Audience
      AI researchers
      ML engineers

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

what do people make with this?

VIBE 1

Benchmark how well an AI research agent gathers and verifies facts across many sources.

VIBE 2

Compare research quality across providers like OpenAI, Anthropic, and Google.

VIBE 3

Run a cheap smoke test to confirm a research pipeline is wired up correctly.

VIBE 4

Develop and regenerate new research task packages for the benchmark.

what's the stack?

PythonDockerHarboruv

how it stacks up fr

perplexityai/wandradriflex/autoremesher-blender-bridgekyutai-labs/hibiki-zero
Stars246247247
LanguagePythonPythonPython
Setup difficultyhardmoderatemoderate
Complexity5/53/54/5
Audienceresearcherdesignerdeveloper

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

how do i run it?

Difficulty · hard time til it works · 1h+

Requires Python 3.12, uv, a running Docker daemon, and paid API keys for multiple AI providers, full runs can be expensive.

The README excerpt provided does not state a license.

in plain english

WANDR is a benchmark, meaning a standardized test, built by Perplexity AI to measure how well an AI system performs at wide and deep research tasks. These are the kinds of jobs that require searching broadly across many sources, gathering a lot of detail from each one, pulling out specific facts, correctly telling similar entities apart, such as two people with the same name, and then producing an answer that is backed by evidence rather than guesswork. The project is organized into four separate pieces that work together. First, there is the raw task data itself, made up of editable configuration files, prompts, and supporting materials. Second, an adapter converts that raw data into a format used by a testing system called Harbor. Third, the generated Harbor-ready task packages are what actually get run and published. Fourth, a component called Relay acts as a general purpose bridge that lets different AI providers, such as OpenAI, Anthropic, or Google, plug into the Harbor testing system in a consistent way. Running WANDR requires Python 3.12, a tool called uv for managing the project, and Docker for running tasks in a controlled environment, plus API keys for whichever AI providers you want to test. A cheap smoke test is available to check that everything is wired up correctly, though it still makes small paid calls to OpenAI and Perplexity. Larger runs, such as validating two representative tasks or running the entire benchmark across six different AI providers, involve significantly more paid API usage, and the README warns clearly that costs are not capped by the system itself. When a task runs, Harbor sets up an isolated environment, Relay sends the task to the AI provider being tested and collects its output files, and then WANDR's own verifier checks the submitted work, cross-references facts, removes duplicate entities, and scores the result. Results are saved as a set of files per run, including a machine readable score, a detailed trajectory of what the AI did, and a human readable HTML report. Anyone wanting to edit or add new tasks works from the original source files, then regenerates the Harbor packages from them rather than editing the generated files directly.

prompts (copy fr)

prompt 1
Walk me through running the smoke-local test for this benchmark.
prompt 2
Explain how Relay connects different AI providers to the Harbor task system.
prompt 3
Show me which API keys I need before running the full validation config.
prompt 4
Help me understand the result files produced after a WANDR run finishes.

Frequently asked questions

what is wandr fr?

A research benchmark from Perplexity AI that tests how well AI systems handle broad, evidence backed information gathering tasks.

What language is wandr written in?

Mainly Python. The stack also includes Python, Docker, Harbor.

What license does wandr use?

The README excerpt provided does not state a license.

How hard is wandr to set up?

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

Who is wandr for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.