Instructions to use Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf:TQ2_0 # Run inference directly in the terminal: llama cli -hf Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf:TQ2_0
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf:TQ2_0 # Run inference directly in the terminal: llama cli -hf Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf:TQ2_0
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf:TQ2_0 # Run inference directly in the terminal: ./llama-cli -hf Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf:TQ2_0
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf:TQ2_0 # Run inference directly in the terminal: ./build/bin/llama-cli -hf Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf:TQ2_0
Use Docker
docker model run hf.co/Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf:TQ2_0
- LM Studio
- Jan
- Ollama
How to use Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf with Ollama:
ollama run hf.co/Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf:TQ2_0
- Unsloth Studio
How to use Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf to start chatting
- Docker Model Runner
How to use Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf with Docker Model Runner:
docker model run hf.co/Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf:TQ2_0
- Lemonade
How to use Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf:TQ2_0
Run and chat with the model
lemonade run user.bitnet-b1.58-2B-4T-tq2_0-gguf-TQ2_0
List all available models
lemonade list
- Atomic Chat
BitNet b1.58 2B4T — TQ2_0 GGUF (mainline llama.cpp)
TQ2_0 conversion of Microsoft's BitNet b1.58 2B4T (MIT), converted on mainline llama.cpp with synapticode-ai/llama.cpp (two small converter patches; conversion walkthrough in docs/tq2_0-anatomy.md).
bf16-equivalent quality at 2.06 bits per weight.
File
| File | Format | Size | sha256 |
|---|---|---|---|
bitnet-2b4t-tq2_0.gguf |
TQ2_0 (2.0625 bpw) | 1.2 GB | 9f8e1097502528a0d80d885c603ea7ee3e4d214a6685356e39baaf697c02cbb6 |
Conversion is deterministic: a fresh bf16 → TQ2_0 conversion on the pinned tree reproduces this file byte-for-byte.
Quality (perplexity, measured)
llama-perplexity, WikiText-2 raw test set (corpus sha256 bbf94c53a05abe9e…),
CPU (-ngl 0), substrate = synapticode-ai/llama.cpp v0.1.0. Same corpus,
commands, and binary for both columns.
| n_ctx | bf16 reference | TQ2_0 (this file) | relative Δ |
|---|---|---|---|
| 512 | 82.09 ± 0.76 | 82.21 ± 0.77 | +0.15% |
| 2048 | 77.16 ± 0.71 | 77.31 ± 0.71 | +0.19% |
2B4T is QAT-trained natively ternary; TQ2_0 is its native alphabet. Absolute values reflect an instruction-tuned model scored on raw text and are comparable only within this methodology.
Throughput (measured, hardware disclosed)
Mac mini M4 Pro, CPU-only (-ngl 0; TQ2_0 has no Metal path):
237–279 tok/s prompt eval, 89–112 tok/s generation.
Run
./build/bin/llama-cli -m bitnet-2b4t-tq2_0.gguf -ngl 0 -p "hello"
Source model © Microsoft, MIT. Conversion: Synapticode · code@synapticode.ai
- Downloads last month
- 220
2-bit
Model tree for Synapticode/bitnet-b1.58-2B-4T-tq2_0-gguf
Base model
microsoft/bitnet-b1.58-2B-4T-bf16