File size: 4,445 Bytes
d10ba4c
 
c6f07f0
 
 
 
 
 
 
 
 
 
 
 
 
d10ba4c
c6f07f0
eebf5da
c6f07f0
 
eebf5da
c6f07f0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
eebf5da
c6f07f0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
eebf5da
c6f07f0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
---
license: apache-2.0
language:
- en
pipeline_tag: text-generation
tags:
- pebble
- language-model
- base-model
- small-language-model
- pytorch
- safetensors
- custom-code
- mamba2
- hybrid
---

# Pebble-10M
![Banner](banner.png)

Pebble-10M is a compact, hybrid autoregressive language model. It combines the efficiency of state-space models with the proven performance of attention layers, optimized using a custom Muon + AdamW optimizer split.
 
## Model Details
 
- **Architecture:** Hybrid Mamba2 / Transformer
- **Block Pattern:** 3 Mamba2 blocks : 1 Attention block (repeating)
- **Parameters:** ~10,000,000 (10M)
- **Hidden Dimension:** 384
- **Layers:** 8 (6 Mamba2, 2 Attention)
- **Vocab Size:** 2,048 (Custom Byte-Level BPE)
- **Context Length:** 512
- **Training Tokens:** ~25,000,000,000 (~25 Billion)
- **Optimizer:** Muon (for 2D hidden weights) + AdamW (for embeddings, norms, and scalars)
- **Precision:** fp32 master weights with bf16 autocast

## Dataset Sources
 
The model was trained on a 25B token subset of the following datasets:
 
| Dataset | Token Allocation | Share |
|---------|---------------------|------|
| FineWeb-Edu | 7.50 billion | 30% |
| DCLM | 5.00 billion | 20% |
| Cosmopedia-v2 | 3.75 billion | 15% |
| FineMath-4+ | 3.75 billion | 15% |
| FinePhrase | 3.00 billion | 12% |
| NPset | 2.00 billion | 8% |

## Benchmarks
 
Pebble-10M performs above random chance on several commonsense and arithmetic benchmarks.
 
| Benchmark | Accuracy | Random Baseline |
|-----------|----------|------------------|
| PIQA | 58.43% | 50.00% |
| ARC-Easy | 37.29% | 25.00% |
| ARC-Challenge | 18.60% | 25.00% |
| HellaSwag | 26.81% | 25.00% |
| ArithMark-2.0 | 27.64% | 25.00% |
| ArithMark-3.0 | 32.80% | 25.00% |
 
### Evaluation Notes

- PIQA, ARC-Easy, ARC-Challenge, and HellaSwag were evaluated on their respective test splits.
- ArithMark-2.0 was evaluated on its train split due to the lack of a suitable test split.
- ArithMark-3.0 was evaluated on its train split due to the lack of a suitable test split.
- Results were obtained using zero-shot multiple-choice evaluation.
- No task-specific fine-tuning was performed.

## Usage
 
To run the model for text generation, you will need to install the required dependencies. The included Mamba2 implementation relies on CUDA/Triton kernels and is intended to run on a CUDA-enabled GPU. Ampere-class GPUs or newer are recommended.
 
> **Note:** The model uses custom architecture code, so you must pass `trust_remote_code=True` when loading both the tokenizer and the model.
 
```bash
pip install transformers huggingface_hub torch
pip install causal-conv1d mamba-ssm
```
 
Here is a simple Python script to load the model and generate text interactively:
 
```python
import torch
from transformers import AutoModelForCausalLM, AutoTokenizer
 
MODEL_ID = "basically-ai/Pebble-10M"
 
def main():
    print("Loading Pebble 10M...")
    tokenizer = AutoTokenizer.from_pretrained(
        MODEL_ID,
        trust_remote_code=True,
    )
    model = AutoModelForCausalLM.from_pretrained(
        MODEL_ID,
        trust_remote_code=True,
        dtype=torch.float32,
    ).to("cuda")
    model.eval()
 
    print(f"Model loaded successfully! VRAM usage: {torch.cuda.memory_allocated() / 1e9:.2f} GB")
    print("Type 'quit' or 'exit' to stop.\n")
 
    while True:
        prompt = input("You: ")
        if prompt.lower() in ["quit", "exit"]:
            break
 
        # Tokenize the prompt
        inputs = tokenizer(prompt, return_tensors="pt").to("cuda")
 
        # Generate text
        print("Pebble: ", end="", flush=True)
        with torch.inference_mode():
            outputs = model.generate(
                **inputs,
                max_new_tokens=100,       # How many tokens to generate
                do_sample=True,           # Use sampling (more creative)
                temperature=0.7,          # Controls randomness
                top_k=50,                 # Consider top 50 tokens
                top_p=0.95,               # Nucleus sampling
                repetition_penalty=1.2,   # Prevent repeating words
            )
 
        # Decode and print (skip the prompt part)
        generated_text = tokenizer.decode(
            outputs[0][inputs["input_ids"].shape[1]:],
            skip_special_tokens=True,
        )
        print(generated_text)
        print()
 
if __name__ == "__main__":
    main()
```

## License

Apache 2.0