wtf is duck-harness?

The Duck is a research project that shares the winning solution to the first milestone of ARC-AGI-3, a competition that tests whether AI systems can reason and adapt to solve new visual puzzle games they were never specifically trained on. This repository contains a full, self-contained writeup of that solution: the code for the solver itself, one complete run of it against the benchmark, and an interactive viewer for looking through that run in detail. The solver, called The Duck, plays these puzzle games by using tools rather than by direct end-to-end prediction, and it runs on top of a framework the team built called TAAF, short for the Tufa ARC-AGI Framework. The README points to a technical writeup on Kaggle, a blog post comparing the approach to others, and both a podcast episode and a YouTube video where the team explains the solution further. The repository is organized into a few clear parts: the actual inference runner with its prompts, run results, scoring code, and viewer, the TAAF framework it runs on, which provides the benchmark and game interaction logic, a complete example run covering 25 official games with 20 attempts each, and a Kaggle notebook that can reproduce a full run from scratch. If you just want to look through the example run without doing anything computationally heavy, you only need basic Python tooling. The instructions have you sync a small set of base dependencies with a package manager called uv, then start a local viewer that opens the bundled example run in a browser, or point it at a different run folder if you have one. Actually running the solver yourself is a bigger step: it needs a GPU and a much larger set of dependencies, including vLLM and PyTorch, and it plays games either through a locally hosted vLLM server or through OpenRouter, an API that provides access to different AI models. The included Kaggle notebook reproduces a full competition run on Kaggle's own hardware, which is the easiest path to actually training or evaluating the full solution.