Skip to content
Language models

Brasa 12M

карманная GPT-модель с нуля для запуска прямо в браузере

3 min readupdated

brasa-12m — сверхкомпактная языковая модель формата GPT на 12,2 миллиона параметров от автора Yanzino6, написанная и обученная полностью с нуля на PyTorch без использования готовых весов и сторонних библиотек. Она решает узкую задачу: отвечает на вопросы об одном конкретном человеке на португальском или английском языках, опираясь на небольшую базу знаний. Главная фишка — весь пайплайн, включая BPE-токенизатор (разбивку текста на фрагменты), гибридный поиск фактов и движок инференса на WebAssembly, создан вручную, поэтому модель весит копейки и работает локально в браузере. Пригодится разработчикам и энтузиастам как эталонный пример компактного RAG-решения (генерации с опорой на поиск) для встраивания в веб-страницы.

Ключевые особенности

  • Полностью с нуля: трансформер (6 слоёв, 384 размерность, SwiGLU, RoPE), байтовый BPE-токенизатор на 4096 токенов и цикл обучения написаны автором самостоятельно без предобученных чекпоинтов.
  • Встроенный гибридный поиск: модель одновременно генерирует ответы и обучена с помощью contrastive loss (контрастивного обучения) ранжировать факты, объединяя классический поиск BM25 со своими эмбеддингами.
  • Браузерный движок без зависимостей: квантованная в int8 версия (web/model.i8.bin) занимает всего 12,3 МБ и запускается в клиенте через WebAssembly SIMD с откатом на обычный JavaScript.
  • Защита от выдумок: поддерживает режим constrained decoding (ограниченной генерации), при котором модель использует только найденные в базе факты и вежливо отказывается отвечать на вопросы вне темы.

Что можно сделать

  • Встроить локального ассистента на сайт: использовать готовый JS/WASM-клиент и бандл model.i8.bin, чтобы запускать вопрос-ответного бота по портфолио или резюме прямо на стороне посетителя без сервера.
  • Изучить архитектуру LLM и RAG на практике: разобрать компактный код на PyTorch как учебный шаблон того, как объединить генеративную модель и dense-ретривер в одной нейросети.
  • Адаптировать под свою мини-базу знаний: переобучить пайплайн на собственном наборе фактов, когда нужен быстрый и полностью контролируемый справочник с минимальным потреблением памяти.

Пример

from huggingface_hub import snapshot_download
from safetensors.torch import load_file
from brasa.model import GPT
from brasa.sample import answer

folder = snapshot_download("Yanzino6/brasa-12m")
out = answer(model, tok, retriever, "Onde o Yan estuda?", prompt_cfg, constrain="retrieved")
print(out["answer"])
ПодробнееКачество RAG: в режиме по умолчанию (open-book + ranking prior) на отложенном тесте (1210 вопросов) модель показывает 48.7% EM (точное совпадение), 62.9% F1 и 0.0% выдуманных чисел; нужный факт попадает в топ-4 поиска в 77.7% случаев.
Вес файлов: 48.8 МБ (float32), 24.4 МБ (float16) и 12.4 МБ (int8 для браузера); длина контекста — 384 токена.
Обучение: сначала предобучение на 246 млн токенов из португальской и английской Википедии (55 минут на ноутбуке, перплексия 20.4), затем 6000 шагов на корпусе вопросов (81 минута на MPS).
Ограничения: модель намеренно узкая — она не является универсальным ассистентом и не знает ничего за пределами своей базы знаний. Лицензия: MIT.
Discuss Telegram 0 21

Will it run?

Runs in F32

Fits without quantisation.

  • F32weights 0.0 GB · ready files0.6 GB
  • BF16weights 0.0 GB0.6 GB
  • FP8 / INT8recommendedweights 0.0 GB0.6 GB
  • 4-bitweights 0.0 GB0.6 GB

Tip: go 8-bit.FP8 / INT8 is within about a percent of full precision in quality, takes half the memory and runs faster on RTX 40/50 and H100. Full precision only pays off for fine-tuning.

What to get for this model

Massed ComputeOpen Massed Compute

Your own GPU: FP8 / INT8 — from RTX 2060 · F32 — from RTX 2060

Massed Compute hourly prices, November 2026. The discounted price applies with the coupon at checkout.

Estimate: weights plus working memory. Long videos, high resolutions and long contexts need more.

Run it on Massed Compute

A ready script for the machine we advise above: paste it and the model downloads and starts.

  1. 1. Rent A30

    $0.26 an hour with the coupon. Pick the Ubuntu image when you create the machine.

    Open Massed Compute
  2. 2. Paste the script into the machine's terminal

    Connect over SSH (the Massed Compute panel shows the command) or open a terminal on the machine's desktop.

    HF_TOKEN / CIVITAI_TOKENThe script starts with token lines: paste yours between the quotes. The Hugging Face token is for gated models, the Civitai one for Civitai models.

    # Yanzino6/brasa-12m — A30, FP8 / INT8
    # NVIDIA driver: CUDA 13 needs 580+. If older or missing, the current nvidia-open is installed (keep yours: KEEP_DRIVER=1)
    DRV=$(nvidia-smi --query-gpu=driver_version --format=csv,noheader 2>/dev/null | head -1 | cut -d. -f1)
    case "$DRV" in ""|*[!0-9]*) DRV=0 ;; esac
    if [ "$DRV" -lt 580 ] && [ -z "${KEEP_DRIVER:-}" ]; then
      . /etc/os-release && \
      curl -fsSLO "https://developer.download.nvidia.com/compute/cuda/repos/ubuntu${VERSION_ID//./}/x86_64/cuda-keyring_1.1-1_all.deb" && \
      sudo dpkg -i cuda-keyring_1.1-1_all.deb && rm -f cuda-keyring_1.1-1_all.deb && \
      sudo apt-get update && \
      sudo DEBIAN_FRONTEND=noninteractive apt-get install -y nvidia-open || \
      { echo "Could not install the NVIDIA driver: see the error above. To keep the current one, run with KEEP_DRIVER=1."; exit 1; }
      echo "NVIDIA driver updated. Reboot the machine (sudo reboot) and run this same script again."
      exit 0
    fi
    curl -LsSf https://astral.sh/uv/install.sh | sh
    source "$HOME/.local/bin/env"
    uv venv ~/vllm --python 3.12 && source ~/vllm/bin/activate
    uv pip install vllm
    vllm serve Yanzino6/brasa-12m --max-model-len 8192 --quantization fp8
    Add more LoRAs to brasa-12m
  3. 3. Use it

    The server listens on port 8000 and speaks the OpenAI API: http://localhost:8000/v1 on the machine. From your computer: ssh -L 8000:localhost:8000 user@machine-IP.

Stop the machine in the panel when you are done: it bills by the minute while it runs.

How to speed it up

Picked for this model type. Choose your hardware above to see what fits you exactly.

  • FlashAttention 44.0.0b40from November 18, 2026new release

    fastest exact attention on B200

    Kernels for Blackwell (beta). Exact attention without quantisation — fine for everything, LLMs included.

    How to enable: pip install flash-attn-4; vLLM and SGLang pick it up themselves.

    Earlier generations (2)
    • FlashAttention 3 — The Hopper (H100/H200) version with FP8.
    • FlashAttention 2 — The standard for RTX 30/40/50 and A100: exact attention without the memory cost of long contexts.
  • torch.compile2.15.0from October 28, 2026new release

    10–30% for free

    Compiles the model for your GPU. Slower first run, faster afterwards.

    How to enable: model = torch.compile(model); in ComfyUI the TorchCompileModel node.

  • MTP (multi-token prediction)0.34.0from November 16, 2026new release

    1.5–2× generation speed

    If the model has MTP layers (DeepSeek-V3/R1, Qwen3-Next, GLM, MiMo and others), it predicts several tokens per step itself.

    How to enable: vLLM / SGLang: --speculative-config '{"method": "mtp", "num_speculative_tokens": 1}'. Check the model card.

    Earlier generations (2)
    • EAGLE-3 — Speculative decoding with a small draft head. For models without their own MTP layers.
    • EAGLE-2 / Medusa — Earlier draft-head generations. Still work if that is all you find.
  • FP8 KV cache0.34.0from November 16, 2026new release

    2× more context in the same memory

    Keeps the attention cache in 8 bits, so long contexts fit where they did not.

    How to enable: vLLM: --kv-cache-dtype fp8; llama.cpp: -ctk q8_0 -ctv q8_0.

  • vLLM / SGLang0.34.0from November 16, 2026new release

    many times more tokens/s on a server

    Server engines: batching, FlashAttention, FP8 and speculative decoding out of the box.

    How to enable: vllm serve <model> — an OpenAI-compatible API.

    Earlier generations (1)
    • llama.cpp — GGUF models on any GPU, Mac or even CPU; some layers can stay in RAM.

Model family

New posts about versions of brasa-12m (quants, finetunes, LoRAs) will show up under the bell.

No known relatives of this model yet. All derivatives on Hugging Face

About the model

Yanzino6/brasa-12m
Author
Yanzino6
Category
Language models
Released
Posted

On NeyroLearn

Hugging Face

210

Ask AI about this model

Answered by Gemini 4 · the chat is kept only in this tab

Comments

Language models

abc-gpt

abc-gpt