Minionese LM is a tiny transformer trained from scratch on an improvised Minionese dialect, capable of playful conversational replies in a consistent fictional language.

Stars

17

7-day growth

No data

Forks

2

Open issues

0

License

MIT

Last updated

2026-07-11

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It demonstrates that a 1.35M-parameter model trained entirely from random initialization can achieve 99% pass rate on behavioral prompts, providing a reproducible end-to-end example of building a custom language model without pretrained weights or large datasets.

Who it is for

  • Hobbyists interested in training small language models from scratch
  • Fans of Minionese or fictional languages exploring generative AI
  • Researchers studying minimal-scale language model training and evaluation
  • Developers looking for a lightweight, portable conversational demo

Use cases

  • Playful chat with a Minionese-speaking bot
  • Educational demonstration of training a decoder-only transformer without transfer learning
  • Portable CPU-only inference for low-resource environments
  • Experimenting with custom tokenizers and fictional language datasets

Strengths

  • Fully reproducible training pipeline from random initialization with detailed evaluation results (99% pass rate, perplexity 1.116)
  • Portable CPU inference across Linux, macOS, and Windows using PyTorch
  • Tiny model size (1.35M parameters) with reasonable conversational quality for its niche domain
  • Explicitly documents limitations and out-of-domain behavior, providing honest expectations

Considerations

  • Very small context window (256 tokens) and limited vocabulary (512 BPE tokens) restricts understanding of complex or out-of-domain English
  • Training requires Apple Silicon; CPU inference is supported but training is not cross-platform
  • Model is a fan project and not an official translator; responses may be malformed for arbitrary input

README quick start

Minionese LM

A tiny conversational decoder-only Transformer trained entirely from scratch on an original Minionese-inspired dataset. It accepts short English or Minionese messages and replies in a playful, consistent Minionese project dialect.

This project does not use pretrained weights, film subtitles, screenplay text, iMessages, or code from the project that inspired the experiment. Minionese is an improvised fictional dialect rather than a language with fixed grammar, so this is explicitly an unofficial fan research project—not an official translator or an Illumination product.

Architecture

  • 4 causal decoder layers
  • 160 model width, 5 attention heads, 640 MLP width
  • learned positional embeddings and tied token/output embeddings
  • 512-token custom byte-level BPE tokenizer
  • 256-token context window
  • MLX training on Apple Silicon, plus PyTorch CPU inference on Linux, macOS, and Windows

The exact parameter count is printed by minionese doctor and saved with every training report.

Trained result

The included local artifact was trained from random initialization for 5,000 batches and 9,981,697 sampled non-padding tokens. On 400 held-out behavioral prompts it achieved 99.0% intent/style/clean pass rate (99.5% for English inputs and 98.5% for Minionese inputs), with test perplexity 1.116 versus a 4.688 unigram baseline. See the full results and artifacts/evaluation.json.

Set up and reproduce

Python 3.11+ and Apple Silicon are required to reproduce training.

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e '.[apple,dev]'
minionese doctor
minionese prepare
minionese train-tokenizer
minionese train
minionese evaluate

Training defaults to 5,000 batches, approximately 8–10 million sampled non-padding tokens depending on generated prompt lengths. The tokenizer and every model parameter begin from random/untrained state. Artifacts are written below artifacts/; large generated data and weights are ignored by Git.

The ready-to-use export is in artifacts/final. To use it explicitly:

minionese reply "hello" --model artifacts/final --tokenizer artifacts/final

Portable CPU inference

The checked-in safetensors export can also run with PyTorch on a CPU-only Linux, macOS, or Windows machine; MLX and Apple Silicon are not required:

python3 -m venv .venv
sourc

Description

A tiny conversational Minionese language model trained from scratch on Apple Silicon

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482