Text Generation
Transformers
Safetensors
English
tinybuddy
tiny-lm
tinystories
educational
built-with-llama
custom_code
Instructions to use Eeppa/TinyBuddy-30M with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Eeppa/TinyBuddy-30M with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="Eeppa/TinyBuddy-30M", trust_remote_code=True)# Load model directly from transformers import AutoModelForCausalLM model = AutoModelForCausalLM.from_pretrained("Eeppa/TinyBuddy-30M", trust_remote_code=True, dtype="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps
- vLLM
How to use Eeppa/TinyBuddy-30M with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Eeppa/TinyBuddy-30M" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Eeppa/TinyBuddy-30M", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/Eeppa/TinyBuddy-30M
- SGLang
How to use Eeppa/TinyBuddy-30M 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 "Eeppa/TinyBuddy-30M" \ --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": "Eeppa/TinyBuddy-30M", "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 "Eeppa/TinyBuddy-30M" \ --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": "Eeppa/TinyBuddy-30M", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use Eeppa/TinyBuddy-30M with Docker Model Runner:
docker model run hf.co/Eeppa/TinyBuddy-30M
| """ | |
| Tiny GPT-style transformer (~30M params target). | |
| """ | |
| import math | |
| import torch | |
| import torch.nn as nn | |
| import torch.nn.functional as F | |
| from transformers import PreTrainedModel, PretrainedConfig | |
| # ========== CONFIG CLASS (embedded to avoid import issues) ========== | |
| class GPTConfig(PretrainedConfig): | |
| model_type = "tinybuddy" | |
| def __init__( | |
| self, | |
| vocab_size: int = 50000, | |
| block_size: int = 128, | |
| n_layer: int = 6, | |
| n_head: int = 8, | |
| n_embd: int = 256, | |
| mlp_ratio: int = 4, | |
| dropout: float = 0.0, | |
| tie_weights: bool = False, | |
| **kwargs | |
| ): | |
| super().__init__(**kwargs) | |
| self.vocab_size = vocab_size | |
| self.block_size = block_size | |
| self.n_layer = n_layer | |
| self.n_head = n_head | |
| self.n_embd = n_embd | |
| self.mlp_ratio = mlp_ratio | |
| self.dropout = dropout | |
| self.tie_weights = tie_weights | |
| # ========== MODEL ARCHITECTURE ========== | |
| class CausalSelfAttention(nn.Module): | |
| def __init__(self, cfg: GPTConfig): | |
| super().__init__() | |
| assert cfg.n_embd % cfg.n_head == 0 | |
| self.n_head = cfg.n_head | |
| self.n_embd = cfg.n_embd | |
| self.head_dim = cfg.n_embd // cfg.n_head | |
| self.qkv = nn.Linear(cfg.n_embd, 3 * cfg.n_embd, bias=True) | |
| self.proj = nn.Linear(cfg.n_embd, cfg.n_embd, bias=True) | |
| self.drop = nn.Dropout(cfg.dropout) | |
| mask = torch.tril(torch.ones(cfg.block_size, cfg.block_size)).bool() | |
| self.register_buffer("mask", mask, persistent=False) | |
| def forward(self, x): | |
| B, T, C = x.shape | |
| qkv = self.qkv(x) | |
| q, k, v = qkv.split(self.n_embd, dim=2) | |
| q = q.view(B, T, self.n_head, self.head_dim).transpose(1, 2) | |
| k = k.view(B, T, self.n_head, self.head_dim).transpose(1, 2) | |
| v = v.view(B, T, self.n_head, self.head_dim).transpose(1, 2) | |
| y = F.scaled_dot_product_attention(q, k, v, is_causal=True, | |
| dropout_p=self.drop.p if self.training else 0.0) | |
| y = y.transpose(1, 2).contiguous().view(B, T, C) | |
| return self.proj(y) | |
| class MLP(nn.Module): | |
| def __init__(self, cfg: GPTConfig): | |
| super().__init__() | |
| hidden = cfg.mlp_ratio * cfg.n_embd | |
| self.fc1 = nn.Linear(cfg.n_embd, hidden, bias=True) | |
| self.fc2 = nn.Linear(hidden, cfg.n_embd, bias=True) | |
| self.drop = nn.Dropout(cfg.dropout) | |
| def forward(self, x): | |
| return self.drop(self.fc2(F.gelu(self.fc1(x)))) | |
| class Block(nn.Module): | |
| def __init__(self, cfg: GPTConfig): | |
| super().__init__() | |
| self.ln1 = nn.LayerNorm(cfg.n_embd) | |
| self.attn = CausalSelfAttention(cfg) | |
| self.ln2 = nn.LayerNorm(cfg.n_embd) | |
| self.mlp = MLP(cfg) | |
| def forward(self, x): | |
| x = x + self.attn(self.ln1(x)) | |
| x = x + self.mlp(self.ln2(x)) | |
| return x | |
| class TinyGPT(PreTrainedModel): | |
| config_class = GPTConfig | |
| def __init__(self, config: GPTConfig): | |
| super().__init__(config) | |
| self.config = config | |
| self.tok_emb = nn.Embedding(config.vocab_size, config.n_embd) | |
| self.pos_emb = nn.Embedding(config.block_size, config.n_embd) | |
| self.drop = nn.Dropout(config.dropout) | |
| self.blocks = nn.ModuleList([Block(config) for _ in range(config.n_layer)]) | |
| self.ln_f = nn.LayerNorm(config.n_embd) | |
| self.lm_head = nn.Linear(config.n_embd, config.vocab_size, bias=False) | |
| if config.tie_weights: | |
| self.lm_head.weight = self.tok_emb.weight | |
| self.post_init() | |
| def _init_weights(self, module): | |
| if isinstance(module, nn.Linear): | |
| module.weight.data.normal_(mean=0.0, std=0.02) | |
| if module.bias is not None: | |
| module.bias.data.zero_() | |
| elif isinstance(module, nn.Embedding): | |
| module.weight.data.normal_(mean=0.0, std=0.02) | |
| def forward(self, input_ids, attention_mask=None, labels=None, **kwargs): | |
| B, T = input_ids.shape | |
| assert T <= self.config.block_size | |
| pos = torch.arange(T, device=input_ids.device) | |
| x = self.tok_emb(input_ids) + self.pos_emb(pos)[None, :, :] | |
| x = self.drop(x) | |
| for blk in self.blocks: | |
| x = blk(x) | |
| x = self.ln_f(x) | |
| logits = self.lm_head(x) | |
| loss = None | |
| if labels is not None: | |
| loss = F.cross_entropy(logits.view(-1, logits.size(-1)), | |
| labels.view(-1), ignore_index=-100) | |
| return (logits,) if loss is None else (logits, loss) | |
| def generate(self, idx, max_new_tokens=100, temperature=1.0, top_k=None): | |
| self.eval() | |
| for _ in range(max_new_tokens): | |
| idx_cond = idx if idx.size(1) <= self.config.block_size else idx[:, -self.config.block_size:] | |
| logits = self(idx_cond)[0] | |
| logits = logits[:, -1, :] / max(temperature, 1e-6) | |
| if top_k is not None: | |
| v, _ = torch.topk(logits, min(top_k, logits.size(-1))) | |
| logits[logits < v[:, [-1]]] = -float("inf") | |
| probs = F.softmax(logits, dim=-1) | |
| next_id = torch.multinomial(probs, num_samples=1) | |
| idx = torch.cat([idx, next_id], dim=1) | |
| return idx | |
| if __name__ == "__main__": | |
| cfg = GPTConfig() | |
| m = TinyGPT(cfg) | |
| total = sum(p.numel() for p in m.parameters()) | |
| print(f"Total params: {total:,} (~{total/1e6:.2f}M)") |