whatisgithub

What is llm-randomness-benchmarks?

ahmad2smile/llm-randomness-benchmarks — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · researcherComplexity · 3/5Setup · moderate

In one sentence

A local benchmark that tests how many real, varied German words small AI models can generate on Apple Silicon, and where they collapse into repetition or junk.

Mindmap

mindmap
  root((repo))
    What it does
      Tests German word generation
      Detects junk and collapse
      Runs on Apple Silicon
    Tech stack
      Python
      MLX
      Hunspell dictionary
    Use cases
      Compare small local models
      Test prompt language effects
      Reuse scoring methodology
    Audience
      ML researchers
      Local model enthusiasts

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

Compare how different small local language models perform on a strict word generation test

USE CASE 2

See how prompt language, German versus English, affects a model's output quality

USE CASE 3

Test whether adding a system prompt helps or hurts a small model's task performance

USE CASE 4

Reuse the scoring approach to detect repetition collapse in your own model evaluations

What is it built with?

PythonMLXHunspell

How does it compare?

ahmad2smile/llm-randomness-benchmarks0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audienceresearchergeneraldeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an Apple Silicon Mac, Python 3.13 or newer, and the uv package manager to install dependencies.

License not stated in the available metadata.

So what is it?

This project is a benchmark that tests how well small AI language models can generate real German words when asked to, running entirely on a Mac with Apple Silicon using a local inference library called MLX. Each model is asked, one thousand times, to give a German word at a specific position with no context, and the results are checked against a real German dictionary to see how many are actual valid words and how varied they are. The test is designed to be difficult on purpose. A model can fail in two different ways that the scoring catches separately: producing junk output that is not a real German word at all, such as English filler text or the model's own internal tokens, or collapsing into repetition, where it gives the same valid word over and over instead of a range of different ones. Validation uses a real spelling dictionary that understands German compound words and grammar, and capitalization is checked too, since German nouns must be capitalized to count as valid. The headline score combines both failure modes into one number: the percentage of distinct valid words out of all one thousand attempts, so a model cannot score well just by repeating one correct word constantly. Several supporting numbers are also tracked, including how many outputs were valid dictionary words at all, how many were unique, and average word length. Running it requires Apple Silicon hardware and a recent Python version, along with a command line tool that generates words for each configured model and then compares the results. The included results table shows no tested model scored above 56 percent, and reveals that whether the prompt is asked in German or English changes performance more than switching between different models does. Adding an extra system prompt on top made every single model perform worse, with one collapsing almost entirely into repeating the word "german" hundreds of times. The project has 0 stars and is written in Python.

Copy-paste prompts

Prompt 1
Help me add a new MLX model to the MODELS list in main.py for this benchmark.
Prompt 2
Explain how the Score, Valid%, and Uniq% metrics differ in this benchmark's results table.
Prompt 3
Walk me through running uv run main.py eval to compare existing results without regenerating them.
Prompt 4
Why did adding a system prompt make every model perform worse in this benchmark's results?

Frequently asked questions

What is llm-randomness-benchmarks?

A local benchmark that tests how many real, varied German words small AI models can generate on Apple Silicon, and where they collapse into repetition or junk.

What language is llm-randomness-benchmarks written in?

Mainly Python. The stack also includes Python, MLX, Hunspell.

What license does llm-randomness-benchmarks use?

License not stated in the available metadata.

How hard is llm-randomness-benchmarks to set up?

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

Who is llm-randomness-benchmarks for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.