Text Generation
Transformers
Safetensors
gpt2
tiny
tiny-lm
small-language-model
subword
bpe
from-scratch
tinystories
charlm
7m-params
text-generation-inference
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
Update card to 4000-step checkpoint: ppl 268.57→55.50, val loss 3.8398→3.7659
Browse files
README.md
CHANGED
|
@@ -38,19 +38,18 @@ A 6.95M-parameter GPT-2 style language model trained **from scratch** on [TinySt
|
|
| 38 |
|
| 39 |
- **Data**: TinyStories (~10M BPE tokens after tokenization)
|
| 40 |
- **Batch size**: 32 sequences × 512 tokens
|
| 41 |
-
- **Steps**:
|
| 42 |
- **LR schedule**: Cosine decay with warmup
|
| 43 |
- **Hardware**: 32-core CPU, ~2 hours
|
| 44 |
-
- **Best val loss**: 3.
|
| 45 |
|
| 46 |
## Evaluation
|
| 47 |
|
| 48 |
| Metric | Value |
|
| 49 |
|--------|-------|
|
| 50 |
-
| Perplexity (held-out TinyStories, 100×512) |
|
| 51 |
-
| Perplexity (mid-dataset, 50×512) | 302.45 |
|
| 52 |
|
| 53 |
-
The held-out perplexity is computed on the last 2M tokens (not seen during training). The gap between train val loss (3.
|
| 54 |
|
| 55 |
## Why subword?
|
| 56 |
|
|
@@ -76,4 +75,4 @@ print(tok.decode(outputs[0], skip_special_tokens=True))
|
|
| 76 |
- 512-token context window
|
| 77 |
- Will produce repetitive or incoherent text on out-of-distribution inputs
|
| 78 |
- Not a chat model, not instruction-tuned
|
| 79 |
-
- Quality is limited by the 7M parameter budget
|
|
|
|
| 38 |
|
| 39 |
- **Data**: TinyStories (~10M BPE tokens after tokenization)
|
| 40 |
- **Batch size**: 32 sequences × 512 tokens
|
| 41 |
+
- **Steps**: 4,000 (best checkpoint)
|
| 42 |
- **LR schedule**: Cosine decay with warmup
|
| 43 |
- **Hardware**: 32-core CPU, ~2 hours
|
| 44 |
+
- **Best val loss**: 3.7659
|
| 45 |
|
| 46 |
## Evaluation
|
| 47 |
|
| 48 |
| Metric | Value |
|
| 49 |
|--------|-------|
|
| 50 |
+
| Perplexity (held-out TinyStories, 100×512) | 55.50 |
|
|
|
|
| 51 |
|
| 52 |
+
The held-out perplexity is computed on the last 2M tokens (not seen during training). The gap between train val loss (3.77) and held-out perplexity (55.5) reflects the difficulty of the TinyStories distribution at this model size.
|
| 53 |
|
| 54 |
## Why subword?
|
| 55 |
|
|
|
|
| 75 |
- 512-token context window
|
| 76 |
- Will produce repetitive or incoherent text on out-of-distribution inputs
|
| 77 |
- Not a chat model, not instruction-tuned
|
| 78 |
+
- Quality is limited by the 7M parameter budget
|