whatisgithub

What is knowledge-cutoff?

apoorvumang/knowledge-cutoff — explained in plain English

Analysis updated 2026-05-18

15PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

In one sentence

A benchmark that estimates a language model's real knowledge cutoff by testing it on real world events month by month.

Mindmap

mindmap
  root((knowledge-cutoff))
    What it does
      Tests models on real events
      Estimates true cutoff date
      Guards against guessing
    Tech stack
      Python
      LLM judge grading
    Use cases
      Model evaluation
      Comparing AI providers
      Research benchmarking
    Audience
      AI researchers
      Developers

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 build with it?

USE CASE 1

Estimate the real effective knowledge cutoff of a specific language model.

USE CASE 2

Compare how different AI providers perform on recent, hard-to-predict events.

USE CASE 3

Add new events to the dataset to keep the benchmark current.

USE CASE 4

Run both direct and multiple choice probes to bracket a model's true knowledge.

What is it built with?

Pythonuv

How does it compare?

apoorvumang/knowledge-cutoff0pen-sourcer/hearth13127905/deep-learning-based-air-gesture-text-recognition-
Stars151515
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audienceresearchervibe coderdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires API keys for whichever language model providers you want to benchmark.

Use freely, including commercially, as long as you give credit to the original author.

So what is it?

knowledge-cutoff is a benchmark that tries to measure what a language model actually knows about the world, month by month, rather than trusting the cutoff date a model's makers advertise. The idea is to ask the model about real world events spread across recent months and see how many it gets right for each month. Since a model's knowledge does not stop sharply on one date but instead fades out gradually, plotting the per-month accuracy reveals roughly where that fade begins. The project is careful to avoid a few ways this kind of test can mislead. Some events are predictable in advance, like an expected election result, so a model could seem to know about them without ever having been trained on the outcome, and the benchmark tags each event by how predictable it was and focuses its main estimate on the least predictable ones. It also separates answers into correct, confidently wrong, or a model simply saying it does not know, since treating an honest, I do not know response the same as a wrong answer would distort the results. To catch a model that just guesses someone is dead for anyone it does not recognize, the dataset includes control questions about people who are definitely alive and about events that never happened at all. Prompts also avoid mentioning today's date so the model cannot infer the answer from context. Using it involves installing with the uv Python tool, adding API keys for whichever AI providers you want to test such as Anthropic, OpenAI, or others, then running a sequence of commands that run the test, grade the answers with an AI judge, and score the results into a cutoff estimate. Results are also published on a live web page and as a dataset on Hugging Face. This is aimed at AI researchers and developers evaluating or comparing language models.

Copy-paste prompts

Prompt 1
Help me install knowledge-cutoff with uv and set up API keys for the models I want to test.
Prompt 2
Walk me through running kc eval to test a model and get its cutoff estimate.
Prompt 3
Explain how knowledge-cutoff avoids scoring a model as knowledgeable just because it guesses correctly.
Prompt 4
Show me how to add a new event to the knowledge-cutoff dataset following its schema.

Frequently asked questions

What is knowledge-cutoff?

A benchmark that estimates a language model's real knowledge cutoff by testing it on real world events month by month.

What language is knowledge-cutoff written in?

Mainly Python. The stack also includes Python, uv.

What license does knowledge-cutoff use?

Use freely, including commercially, as long as you give credit to the original author.

How hard is knowledge-cutoff to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is knowledge-cutoff for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.