Instructions to use Compactbot/subword-gpt-7m with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Compactbot/subword-gpt-7m with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="Compactbot/subword-gpt-7m")# Load model directly from transformers import AutoTokenizer, GPT tokenizer = AutoTokenizer.from_pretrained("Compactbot/subword-gpt-7m") model = GPT.from_pretrained("Compactbot/subword-gpt-7m", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use Compactbot/subword-gpt-7m with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Compactbot/subword-gpt-7m" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Compactbot/subword-gpt-7m", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/Compactbot/subword-gpt-7m
- SGLang
How to use Compactbot/subword-gpt-7m with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "Compactbot/subword-gpt-7m" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Compactbot/subword-gpt-7m", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "Compactbot/subword-gpt-7m" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Compactbot/subword-gpt-7m", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use Compactbot/subword-gpt-7m with Docker Model Runner:
docker model run hf.co/Compactbot/subword-gpt-7m
Configuration Parsing Warning:Invalid JSON for config file tokenizer_config.json
Subword GPT 7M
A 6.95M-parameter GPT-2 style language model trained from scratch on TinyStories using a custom BPE-8192 tokenizer.
Architecture
| Parameter | Value |
|---|---|
| Layers | 6 |
| Hidden dim | 256 |
| Heads | 8 |
| FFN dim | 1024 |
| Vocab | 8192 (BPE) |
| Max position | 512 |
| Tied embeddings | Yes |
| Biases | No |
| Norm | RMSNorm |
| Activation | GELU |
| Total params | 6,950,144 |
Training
- Data: TinyStories (~10M BPE tokens after tokenization)
- Batch size: 32 sequences ร 512 tokens
- Steps: 4,000 (best checkpoint)
- LR schedule: Cosine decay with warmup
- Hardware: 32-core CPU, ~2 hours
- Best val loss: 3.7659
Evaluation
Held-out perplexity
| Metric | Value |
|---|---|
| Perplexity (held-out TinyStories, 100ร512) | 48.43 |
The held-out perplexity is computed on the last 2M tokens (not seen during training). Note that this figure has meaningful sample variance: a 100ร512 draw gives 48.43 (seed 123) while the first 20ร512 slice gives 55.39 โ both are honest draws from the same distribution, and the spread (not a bug) reflects how uneven the TinyStories difficulty is at this model size. The gap between train val loss (3.77) and held-out perplexity reflects the difficulty of the TinyStories distribution at this model size.
Zero-shot benchmarks
Measured with length-normalized loglikelihood scoring (each answer choice scored as a continuation of the prompt; argmax of mean per-token logprob vs. gold). 400 examples per task, 32-core CPU.
| Task | Split | Accuracy | Chance (4-choice) |
|---|---|---|---|
| ARC-Easy | test | 23.5% | 25% |
| ARC-Challenge | test | 19.5% | 25% |
| HellaSwag | validation | 23.75% | 25% |
| SciQ | test | 23.0% | 25% |
All four tasks sit at or below the 25% four-choice chance level. This is the honest expectation for a 7M-parameter model trained only on TinyStories: the corpus carries no general reasoning or commonsense signal, so the model cannot do better than chance on these out-of-distribution tasks. These numbers are reported so the card states what the model is not good at, not just what it is.
Why subword?
This model is a direct comparison to my earlier char-gpt-1.2m (character-level, 1.2M params). At equal compute budget, subword tokenization sees ~4ร more text per step and produces significantly better language modeling. This is the "subword beats character" result.
Usage
from transformers import AutoTokenizer, AutoModelForCausalLM
model = AutoModelForCausalLM.from_pretrained("Compactbot/subword-gpt-7m")
tok = AutoTokenizer.from_pretrained("Compactbot/subword-gpt-7m")
text = "Once upon a time, there was a little cat."
inputs = tok(text, return_tensors="pt")
outputs = model.generate(**inputs, max_new_tokens=100, do_sample=True, temperature=0.8)
print(tok.decode(outputs[0], skip_special_tokens=True))
Limitations
- Trained only on TinyStories (simple English stories for children)
- 512-token context window
- Will produce repetitive or incoherent text on out-of-distribution inputs
- Not a chat model, not instruction-tuned
- Near-chance on general reasoning/commonsense benchmarks (see table above) โ no general knowledge signal in the training data
- Quality is limited by the 7M parameter budget
Reproduction
Training script: see generation.py for inference. The training code is available in the CompactAI workspace. Benchmark harness: eval_bench.py (loglikelihood scoring) and eval_validate2.py (held-out perplexity).
- Downloads last month
- 49