---
library_name: transformers
pipeline_tag: translation
tags:
- t5
- seq2seq
- onnx
- transformers.js
- browser-ml
- timers
- synthetic-data
datasets:
- Satansdeer/timmy-t2-timer-sft
license: apache-2.0
---

# Timmy T2

Timmy T2 stands for **Timmy Timer Translator**. It is a tiny, browser-first seq2seq model for translating natural-language timer requests into Timey's compact action DSL.

This is not a new foundation architecture. It is a task-specific fine-tuned T5-style encoder-decoder model plus a compact output language, lossless slot-annotated input format, constrained parser, and browser ONNX runtime package.

## Release

- Version: `v0.1.0`
- Runtime model version: `phase4y-actions-browser-exact-checkpoint-50-dynq8enc-q4dec-ort-beam4`
- Production commit: `6ea2d2a`
- Production deploy: `6a0ed36e0172c100ef1ab8ac`
- Dataset: [Satansdeer/timmy-t2-timer-sft](https://huggingface.co/datasets/Satansdeer/timmy-t2-timer-sft)

## Intended Use

Timmy T2 is intended for Timey-style timer planning:

```text
5 one minute timers and one 30 second
```

The model emits action commands over extracted slot ids:

```text
REP C0 A0
ADD A1
END
```

The application parses those commands into concrete timers deterministically.

## Files

- Root files are the fp32/safetensors checkpoint for Python Transformers.
- `browser/` contains the production browser artifact:
  - dynamic q8 encoder ONNX
  - q4 decoder ONNX
  - tokenizer/config files used by the Timey browser runtime
- `eval/` contains release evaluation summaries.
- `release_manifest.json` records hashes, sizes, evals, and production smoke checks.

## Training Data

Public dataset rows:

| Split | Rows |
| --- | ---: |
| train | 2639 |
| validation | 207 |
| hard_validation | 62 |
| all_public | 2846 |

The 16-row hidden validation split is withheld from the public dataset to preserve a private holdout.

## Evaluation

| Eval | Records | Parseable | Strict exact | Semantic exact | Semantic invalid |
| --- | ---: | ---: | ---: | ---: | ---: |
| onnx-dynq8enc-q4dec-validation | 207 | 100% | 100% | 100% | 0% |
| onnx-dynq8enc-q4dec-hard | 62 | 100% | 100% | 100% | 0% |
| onnx-dynq8enc-q4dec-hidden | 16 | 100% | 100% | 100% | 0% |
| onnx-dynq8enc-q4dec-browser-failures | 3 | 100% | 100% | 100% | 0% |
| fp32-validation | 207 | 100% | 100% | 100% | 0% |
| fp32-hard | 62 | 100% | 100% | 100% | 0% |
| fp32-hidden | 16 | 100% | 100% | 100% | 0% |

## Browser Smoke

The deployed production browser runtime was smoke-tested with service workers enabled. It loaded `timey-t5-efficient-tiny` and produced the expected timer sequences for:

- `5 one minute timers and one 30 second` -> `[60, 60, 60, 60, 60, 30]`
- `first and last timer 5 minute, 5 one minute timers in between` -> `[300, 60, 60, 60, 60, 60, 300]`

## Limitations

- This is a narrow task model for timer requests, not a general assistant.
- It expects Timey's lossless slot-annotated input format at inference time.
- Correction/edit requests are intentionally handled by deterministic fallback logic in the app.
- Public validation is synthetic and task-targeted; broader natural user traffic should be evaluated before expanding claims.