Instructions to use Remek/basal-2.0-max-MLX-8bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use Remek/basal-2.0-max-MLX-8bit with MLX:
# Make sure mlx-lm is installed # pip install --upgrade mlx-lm # Generate text with mlx-lm from mlx_lm import load, generate model, tokenizer = load("Remek/basal-2.0-max-MLX-8bit") prompt = "Write a story about Einstein" messages = [{"role": "user", "content": prompt}] prompt = tokenizer.apply_chat_template( messages, add_generation_prompt=True ) text = generate(model, tokenizer, prompt=prompt, verbose=True) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- MLX LM
How to use Remek/basal-2.0-max-MLX-8bit with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "Remek/basal-2.0-max-MLX-8bit"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "Remek/basal-2.0-max-MLX-8bit" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Remek/basal-2.0-max-MLX-8bit", "messages": [ {"role": "user", "content": "Hello"} ] }' - Atomic Chat
basal-2.0-max-MLX-8bit
MLX 8-bit weights for Apple Silicon of basal-2.0-max (11B, base Bielik-PL-11B-v3.0-Instruct). Same model, same typed-decision API through basal-serve; the calibration files this folder ships are listed below.
Measured against bf16
Agreement is the share of decisions where the port picks the same option as the bf16 release model on the development set dev v2 (MLX rows: every 8th dev v2 decision, 1,700 decisions). Bars for this tier: agreement 2-10 >= 0.9552, agreement at reference margin >= 0.2 >= 0.9893, accuracy within 1 point of bf16, ECE at most +0.01. All ports of this tier:
| package | agreement with bf16 (options 2-10) | agreement at margin >= 0.2 | accuracy diff | ECE diff | size | speed | gate |
|---|---|---|---|---|---|---|---|
| FP8 | 0.9704 | 0.9948 | +0.0005 | -0.0010 | 12 GB | 19.9 dec/s c16, c1 p50 50 ms (H100) | PASS |
| GGUF Q8_0 | 0.9925 | 0.9997 | +0.0002 | +0.0018 | 12 GB | not measured in this release | PASS |
| GGUF Q5_K_M | 0.9766 | 0.9970 | -0.0001 | +0.0032 | 7.5 GB | not measured in this release | PASS |
| MLX 8-bit | 0.9933 | 0.9990 | +0.0017 | +0.0053 | 12 GB | 622 ms c1 p50, 1506 ms for 5 questions (Mac) | PASS |
The ports are decision-layer checks against bf16, not new benchmarks; the model's own results are on basal-2.0-max.
Use
uv venv --python 3.12 --allow-existing ~/basal-mlx && source ~/basal-mlx/bin/activate
uv pip install "basal[mlx] @ https://github.com/rkinas/basal/archive/refs/tags/v2.0.0.tar.gz"
basal-serve --model Remek/basal-2.0-max-MLX-8bit --mode mlx --port 8000
Speed: 622 ms c1 p50, 1506 ms for 5 questions (Mac). Measured on Apple M4 Pro, 24 GB.
Memory. The package is 12 GB; it needs most of the GPU working set of a 24 GB Mac. It was measured on Apple M4 Pro, 24 GB, with no other GPU app running; with another ~5 GB MLX server up it failed with Metal "Insufficient Memory". Close other GPU apps first.
Engine. The same basal engine v2.0.0 also serves the experimental basal-omni-1.0 models (images and audio): README.
Calibration
CALIBRATION.json in this folder is the bf16 model's calibration, the default for every mode without a fit of its own. basal-serve --mode mlx loads CALIBRATION.<engine>.json for its engine when the folder has it, else CALIBRATION.json. A calibration fitted on bf16 readouts does not carry over exactly to a quantised port (an outside test of
basal-1.5 on Ollama saw 2.3% real error at the 1% threshold with the bf16 file), so a port-specific fit, where it passed,
uses the bf16 model's method on that port's own readouts of the same calibration splits, one option order:
basal-serve --mode mlx: ShipsCALIBRATION.mlx.json, fitted on MLX readouts of this port (same method as the bf16 fit, one option order); dev v2 ECE 0.0346 with the bf16 fit -> 0.0365 with this fit (in-sample), 0.0409 held-out (leave-one-family-out).
Where a port uses the bf16 calibration, treat its confidence thresholds as approximate and fit your own with
basal-calibrate when they matter.
Results of the model
See the model card basal-2.0-max for Werdykt, JDI, LEK, PL-Holdout and PL-Real numbers against basal-1.5 and the evaluation notes. This port is not scored separately on those benchmarks.
Limitations
- Validate on your own documents before relying on it: hidden and held-out sets do not cover every domain.
- Polish world knowledge of a small model is limited: put the relevant facts in the state. Legal rules change.
- Exact arithmetic and thresholds are a weak spot of one-pass decisions: compute them in code (or
"facts": "auto"). - The calibration is cautious on unseen tasks: no 1% threshold is certified in the shipped files, so
"max_error": 0.01on anactortoolquestion defers every decision; use 0.05, or certify thresholds on your own data withbasal-calibrate. actandmultiover many labels are experimental. Up to 255 options per question (Ollama: 20); the context is 32,768 tokens. The 2.0 models ship no evidence head.- Decisions with serious consequences for people should be reviewed by a person.
Citation
@software{kinas2026basal20,
title = {basal-2.0: typed-decision models and inference engine for Polish and English},
author = {Kinas, Remigiusz},
year = {2026},
version = {2.0.0},
url = {https://github.com/rkinas/basal}
}
License and attribution
Apache-2.0. Fine-tuned from speakleash/Bielik-PL-11B-v3.0-Instruct (Apache-2.0). Bielik is a project of SpeakLeash and ACK Cyfronet AGH.
- Downloads last month
- 4
8-bit
Model tree for Remek/basal-2.0-max-MLX-8bit
Base model
speakleash/Bielik-11B-v3-Base-20250730