Text Generation
Transformers
Safetensors
mini-beatrix
byte-level
tokenizer-free
aleph
signed-address
custom_code
Instructions to use AbstractPhil/mini-beatrix-1 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use AbstractPhil/mini-beatrix-1 with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="AbstractPhil/mini-beatrix-1", trust_remote_code=True)# Load model directly from transformers import AutoModelForCausalLM model = AutoModelForCausalLM.from_pretrained("AbstractPhil/mini-beatrix-1", trust_remote_code=True, device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use AbstractPhil/mini-beatrix-1 with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "AbstractPhil/mini-beatrix-1" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "AbstractPhil/mini-beatrix-1", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/AbstractPhil/mini-beatrix-1
- SGLang
How to use AbstractPhil/mini-beatrix-1 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 "AbstractPhil/mini-beatrix-1" \ --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": "AbstractPhil/mini-beatrix-1", "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 "AbstractPhil/mini-beatrix-1" \ --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": "AbstractPhil/mini-beatrix-1", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use AbstractPhil/mini-beatrix-1 with Docker Model Runner:
docker model run hf.co/AbstractPhil/mini-beatrix-1
File size: 6,569 Bytes
b007aec | 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 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 | """Mission presets — the Mini-Beatrix ladder.
Naming convention (voyager style): numbered missions, each a fixed craft.
Small crafts are "mini-beatrix-N"; the BPE flagship is "beatrix-voyager".
Beatrix is the lineage collective name; missions are launched in order and
all upload to the one training repo (TRAINING_REPO), each craft under its
own path prefix (checkpoints + manifest + tensorboard).
mini-beatrix-0 d512 L12 ctx1024 byte-trigram 37.6M gate craft:
its first toggle evals ARE the anchored-bank-under-AR
screen (P1) running live.
mini-beatrix-1 d768 L16 ctx2048 byte-trigram 112.5M first Colab
mission (default).
mini-beatrix-2 d1024 L20 ctx2048 byte-trigram 249.1M
beatrix-voyager d1536 L24 ctx4096 BPE(gpt2 50k) 775.3M flagship;
vocab-scale head + BPE screens (P2/P5) still open —
launch only after mini-beatrix verdicts.
Every craft is inference-capable on consumer hardware in its shipped
form (fp8-e4m3 safetensors variants are exported alongside checkpoints).
"""
from __future__ import annotations
from dataclasses import dataclass, field, asdict
from typing import Optional
@dataclass
class AlephLMConfig:
name: str = "mini-beatrix-0"
d_model: int = 512
n_layers: int = 12
n_heads: int = 8
context: int = 1024
vocab_size: int = 256 # bytes; BPE presets override
tokenizer: str = "byte-trigram" # "byte-trigram" | "hf:<repo or name>"
hub_layers: tuple = (3, 7, 11) # CausalSplatHUB depths; () = pure sdpa control
hub_K: int = 512
hub_D: int = 32
tau: float = 0.1
bank_experts: int = 3 # E1-validated fat-expert count
bank_ff: Optional[int] = None # None -> d_model (E1 ratio)
head_K: int = 512
head_D: int = 32
gate_init: float = -3.0
tie_embeddings: bool = False # BPE crafts tie; byte crafts cannot (trigram)
hub_chunk: int = 128 # chunked-scan block for the hub prefix memories
def to_dict(self):
d = asdict(self)
d["hub_layers"] = list(self.hub_layers)
return d
@staticmethod
def from_dict(d):
d = dict(d)
d["hub_layers"] = tuple(d.get("hub_layers", ()))
return AlephLMConfig(**d)
@dataclass
class TrainConfig:
# Optimizer split (measured: momentum-geometric +.09 on the aleph;
# the mechanism is ~20x more optimizer-sensitive than sdpa).
muon_lr: float = 2e-2
muon_momentum: float = 0.95
adam_lr: float = 3e-4 # pure Adam, wd=0 — never AdamW
warmup_steps: int = 200 # scale insurance; flat after (flat-LR law)
grad_clip: float = 1.0
micro_batch: int = 24
grad_accum: int = 1
# Cadences (steps)
log_every: int = 50
health_every: int = 500
eval_every: int = 2000
ckpt_every: int = 2000 # safetensors + resume .pt
fp8_every_ckpts: int = 5 # every Nth checkpoint also exports fp8
tb_upload_every: int = 1000
# Eval sizes
val_tokens: int = 262144
canary_episodes: int = 128
seed: int = 1337
compile: bool = False
# All missions upload to the one training repo, each under its own prefix
# (Phil's repo: checkpoints + manifests + tensorboard for every craft).
TRAINING_REPO = "AbstractPhil/alephllm-mini-beatrix-training"
@dataclass
class Preset:
model: AlephLMConfig
train: TrainConfig
hf_repo: str = TRAINING_REPO # run repo (ckpts+manifest+tb)
curriculum: list = field(default_factory=list) # [(phase, dataset, planned_tokens)]
@property
def prefix(self) -> str: # path prefix inside hf_repo
return self.model.name
def _curriculum(warm: int, main: int, ext: int):
return [
dict(name="warmup_wikitext", dataset="wikitext-103", planned_tokens=warm,
status="planned"),
dict(name="fineweb_main", dataset="fineweb-edu", planned_tokens=main,
status="planned"),
# Deliberately not prepped beyond a name — the full plan exists in the
# manifest, the data work happens when the phase activates.
dict(name="fineweb_extended", dataset="fineweb-edu", planned_tokens=ext,
status="deferred"),
# phase C: distribution shift toward chat format / simple register /
# narrative (incl. moral texture) / binding demand — see streams.ANNEAL_MIX
dict(name="anneal_mix", dataset="anneal-mix",
planned_tokens=2_000_000_000, status="deferred"),
]
PRESETS: dict[str, Preset] = {
"mini-beatrix-0": Preset(
model=AlephLMConfig(name="mini-beatrix-0"),
train=TrainConfig(micro_batch=96, grad_accum=1),
curriculum=_curriculum(150_000_000, 1_000_000_000, 2_000_000_000),
),
"mini-beatrix-1": Preset(
model=AlephLMConfig(name="mini-beatrix-1", d_model=768, n_layers=16,
n_heads=12, context=2048, hub_layers=(4, 9, 14)),
train=TrainConfig(micro_batch=48, grad_accum=3),
curriculum=_curriculum(300_000_000, 3_000_000_000, 6_000_000_000),
),
"mini-beatrix-2": Preset(
model=AlephLMConfig(name="mini-beatrix-2", d_model=1024, n_layers=20,
n_heads=16, context=2048, hub_layers=(5, 11, 17)),
train=TrainConfig(micro_batch=32, grad_accum=6),
curriculum=_curriculum(300_000_000, 5_000_000_000, 10_000_000_000),
),
"beatrix-voyager": Preset(
model=AlephLMConfig(name="beatrix-voyager", d_model=1536, n_layers=24,
n_heads=16, context=4096, vocab_size=50257,
tokenizer="hf:gpt2", tie_embeddings=True,
hub_layers=(6, 13, 20)),
train=TrainConfig(micro_batch=8, grad_accum=16),
curriculum=_curriculum(500_000_000, 12_000_000_000, 24_000_000_000),
),
}
# Pure-sdpa control crafts (hub layers removed) — the running architecture
# control for any mission: same params otherwise, suffix "-control".
for _name in list(PRESETS):
_p = PRESETS[_name]
_m = AlephLMConfig.from_dict(_p.model.to_dict())
_m.name = _name + "-control"
_m.hub_layers = ()
PRESETS[_name + "-control"] = Preset(
model=_m, train=_p.train,
curriculum=[dict(x) for x in _p.curriculum])
def get_preset(name: str) -> Preset:
if name not in PRESETS:
raise KeyError(f"unknown preset '{name}' — have: {sorted(PRESETS)}")
return PRESETS[name]
|