Skip to main content

GlubLM

License

the language model that already forgot this sentence

GlubLM is a 35M-parameter transformer that plays a goldfish with a 10-second memory. Inspired by GuppyLM and Ted Lasso's "be a goldfish" meditation on the happiest animal on earth, GlubLM has a hard 96-token context window - it literally cannot remember what was just said.

Unlike GuppyLM, GlubLM:

  • uses modern transformer components: RoPE + SwiGLU + RMSNorm
  • was trained on an 80K LLM-generated dataset produced by a team of four Claude agents, not hand-authored templates
  • runs in your browser via quantized ONNX (~40 MB) - try the demo

Quick start

Browser

Open the demo. Everything runs client-side - no backend.

Python

pip install glublm
glublm chat \
  --ckpt /path/to/glublm_60k_15ep.pt \
  --tokenizer /path/to/tokenizer_60k.json \
  --prompt "hello"

Or download the model from HuggingFace:

from huggingface_hub import hf_hub_download
ckpt = hf_hub_download("DenSec02/glublm-18m", "model.safetensors")
tok  = hf_hub_download("DenSec02/glublm-18m", "tokenizer.json")

Train from scratch

  1. Clone this repo
  2. pip install -e ".[dev,deploy]"
  3. Generate the dataset (see docs/DATASET.md)
  4. Train: glublm train --data data/glublm_60k.json --epochs 15 --batch-size 64 --lr 3e-4
  5. See docs/TRAINING.md for details

Architecture

  • ~36.1M parameters, 8 decoder-only transformer blocks
  • hidden 640, 10 attention heads, SwiGLU FFN (1280x2), RMSNorm
  • RoPE position encoding
  • Vocabulary: 5,120 BPE
  • Max context: 96 tokens (hard cap - the physical 10-second memory)
  • Test perplexity: 3.28

Details: docs/ARCHITECTURE.md

Comparison vs GuppyLM

See docs/COMPARISONS.md for the empirical comparison. Short version: GlubLM tests the hypothesis that modern ops help at sub-40M scale, which is something GuppyLM explicitly decided against.

Links

Credits

  • GuppyLM by Arman BD - the original tiny fish-persona model
  • Ted Lasso - the "be a goldfish" philosophy
  • Anthropic Claude - the multi-agent dataset generation team

License

AGPL-3.0 - see LICENSE.

Citation

@software{glublm_2026,
  author = {Sepede, Dennis},
  title = {GlubLM: a 35M goldfish language model with a 10-second memory},
  year = {2026},
  url = {https://github.com/Den-Sec/glublm}
}

Release files for glublm 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for glublm 0.3.1
File Size Uploaded
glublm-0.3.1.tar.gz 32.6 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for glublm 0.3.1
File Interpreter ABI Platform
glublm-0.3.1-py3-none-any.whl Python 3 none any Details

Total release size:32.6 MB

Release files / glublm-0.3.1.tar.gz

Download URL glublm-0.3.1.tar.gz
Size 32.6 MB
Tags Source
SHA-256 checksum
How to use checksums
497b5a006c7c93b6bd7d2b119b40ab29c725431201a3ac1860727aaf60de105b
BLAKE2b-256 checksum
How to use checksums
c44f9839349d929278a71208a8f6a3ddeac7f0e5c3cd3442377198f9c7283794
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 10, 2026.

Transparency log

Release files / glublm-0.3.1-py3-none-any.whl

Download URL glublm-0.3.1-py3-none-any.whl
Size 27.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ffb837395a29436db15ac78eeff233004e59201eab71be67358f93907855b606
BLAKE2b-256 checksum
How to use checksums
df333d123f5788d68bdd06069258cf06f3b40bed609fc6c98df8f8f16457a7ff
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 10, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.3.1 This release

2 release files

0.3.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page