CoolFace
Modelpublic

Harley-ml/PicoWord-5k

sourceHugging Facemitupdated 4mo agoView on Hugging Face
1likes33downloads
Model Card

PicoWord-5k

Have you ever dreamed of a model that could fit on your toaster oven? Well, meet PicoWord, the smallest variant in the The Word family. PicoWord is a five-thousand parameter transformer trained on seven-hundred and fifty-three thousand words.

Architecture

ParameterValue
NUMHIDDENLAYERS1
HIDDEN_SIZE4
NUMATTENTIONHEADS1
NUMKEYVALUE_HEADS1
VOCAB_SIZE1200
INTERMEDIATE_SIZE16
ROPE_THETA1000.0
MAXPOSITIONEMBEDDINGS32
TIEWORDEMBEDDINGSTrue

Note:

No layers. NO. NO LAYERS. Fine.. Maybe ONE layer.

Training

Dataset

KeyValue
Entries (words)753,232
Tokens3,225,398
Characters7,022,310
Avg. Tokens Per Entry~4.2
Avg. Words Per Entry1
Avg. Chars Per Entry~9.3
Longest Entry (Tokens)36
Shortest Entry (Tokens)1
English Words~660k
Spanish Words~90k

Hardware

PicoWord was trained on one NVIDIA RTX 2060 GPU for 8 epochs with a batch size of 64.

Training Results

StepEpochTrain LossTrain PPLEval LossVal PPL
30000.784.9279138.094.8546128.35
60001.564.597299.204.574297.00
90002.344.482888.484.471787.52
120003.124.439984.784.434384.30
150003.904.424083.434.412982.52
180004.684.413682.574.403981.77
210005.454.398481.334.391180.74
240006.234.398281.324.387680.45
270007.014.391980.804.384280.17
300007.794.392680.854.381579.98

Due to the small parameter size, PicoWord plateued early, which is expected.

Generations

Generation1

Prompt: wh Output:

why
Generation2

Prompt: a Output:

aitee
Generatiion3

Prompt: w Output:

wiized

The generations are varied but as you can tell, most generations will not be real words. The goal is to reflect the morphology of the English and Spanish languages, not memorized word generation.

Limitations

  1. 1.It does not generate sentences, prose, code, or anything besides a single word-like sequence.
  2. 2.It cannot reason or produce complex language.
  3. 3.Generated words may or may not be real. The goal isn't real word generation but reflecting the lexicon and morphology of the English and Spanish languages through tiny language models.
  4. 4.Output is non-deterministic. The same prompt can produce very different completions across runs.
  5. 5.Some continuations may be empty. This is because, most words are tiny, and the model feels like the input does not need to be continued further.

Inference

python
# =============================================================================
# Inference
# =============================================================================

MODEL_DIR      = "harley-ml/PicoWord-5k"   # path
TOKENIZER_PATH = "harley-ml/PicoWord-5k"

# --- Generation settings ---
PROMPT             = "w"   # prompt
MAX_NEW_TOKENS     = 32
TEMPERATURE        = 1.2
TOP_P              = 0.95
TOP_K              = 200
REPETITION_PENALTY = 1.1
DO_SAMPLE          = True

# =============================================================================

import torch
from pathlib import Path
from transformers import (
    AutoModelForCausalLM,
    PreTrainedTokenizerFast,
    AddedToken,
)

# ---------------------------------------------------------------------------
# Device
# ---------------------------------------------------------------------------

device = (
    "cuda" if torch.cuda.is_available() else
    "mps"  if torch.backends.mps.is_available() else
    "cpu"
)
print(f"Device : {device}")

# ---------------------------------------------------------------------------
# Tokenizer  (mirrors training setup)
# ---------------------------------------------------------------------------

def load_tokenizer(path: str):
    p = Path(path).resolve()
    if not p.exists():
        raise FileNotFoundError(f"Tokenizer not found: {p}")
    tok = PreTrainedTokenizerFast(tokenizer_file=str(p))
    specials = {}
    if tok.bos_token is None: specials["bos_token"] = AddedToken("<|bos|>", special=True)
    if tok.eos_token is None: specials["eos_token"] = AddedToken("<|eos|>", special=True)
    if tok.unk_token is None: specials["unk_token"] = AddedToken("<|unk|>", special=True)
    if tok.pad_token is None:
        if tok.eos_token is not None:
            tok.pad_token = tok.eos_token
        else:
            specials["pad_token"] = AddedToken("<|pad|>", special=True)
    if specials:
        tok.add_special_tokens(specials)
    tok.padding_side = "left"  # left-pad for batched generation
    return tok

print("Loading tokenizer...")
tokenizer = load_tokenizer(TOKENIZER_PATH)
print(f"  Vocab size : {tokenizer.vocab_size}")
print(f"  BOS        : {tokenizer.bos_token!r}")
print(f"  EOS        : {tokenizer.eos_token!r}")
print(f"  PAD        : {tokenizer.pad_token!r}  (id={tokenizer.pad_token_id})")

# ---------------------------------------------------------------------------
# Model
# ---------------------------------------------------------------------------

print(f"\nLoading model from {MODEL_DIR} ...")
model = AutoModelForCausalLM.from_pretrained(
    MODEL_DIR,
    dtype=torch.float16 if device == "cuda" else torch.float32,
    low_cpu_mem_usage=True,
)
model.eval()
model.to(device)

total_params = sum(p.numel() for p in model.parameters())
print(f"  Parameters : {total_params:,}")

# ---------------------------------------------------------------------------
# Generation helper
# ---------------------------------------------------------------------------

def generate(
    prompt: str             = PROMPT,
    max_new_tokens: int     = MAX_NEW_TOKENS,
    temperature: float      = TEMPERATURE,
    top_p: float            = TOP_P,
    top_k: int              = TOP_K,
    repetition_penalty: float = REPETITION_PENALTY,
    do_sample: bool         = DO_SAMPLE,
) -> str:
    
    bos         = tokenizer.bos_token or ""
    full_prompt = bos + prompt

    inputs = tokenizer(
        full_prompt,
        return_tensors="pt",
        add_special_tokens=False,
    ).to(device)
    inputs.pop("token_type_ids", None)  # Qwen3 doesn't use this

    gen_kwargs = dict(
        max_new_tokens     = max_new_tokens,
        do_sample          = do_sample,
        repetition_penalty = repetition_penalty,
        eos_token_id       = tokenizer.eos_token_id,
        pad_token_id       = tokenizer.pad_token_id,
    )
    if do_sample:
        gen_kwargs["temperature"] = temperature
        gen_kwargs["top_p"]       = top_p
        gen_kwargs["top_k"]       = top_k

    with torch.inference_mode():
        output_ids = model.generate(**inputs, **gen_kwargs)

    # Strip the prompt tokens so we only return what was generated
    prompt_len = inputs["input_ids"].shape[-1]
    new_ids    = output_ids[0][prompt_len:]
    return tokenizer.decode(new_ids, skip_special_tokens=True)


# ---------------------------------------------------------------------------
# Run
# ---------------------------------------------------------------------------

if __name__ == "__main__":
    print(f"\nPrompt : {PROMPT!r}")
    print("-" * 60)

    output = generate(PROMPT)

    print("Generated:")
    print(output)

Related Models

  1. 1.MicroWord
  2. 2.TinyWord
  3. 3.TinyWord2
  4. 4.MediumWord
  5. 5.LargeWord

Citation

bibtex
@misc{picoword-5k,
  title     = {PicoWord-5k: A Test of Morphological Compression in TLMs},
  author    = {Harley-ml},
  year      = {2026},
  url       = {https://huggingface.co/Harley-ml/PicoWord-5k}
}