AI21-Jamba-Reasoning-3B-GGUF

Introduction

AI21’s Jamba Reasoning 3B is a top-performing reasoning model that packs leading scores on intelligence benchmarks and highly-efficient processing into a compact 3B build. <br> Read the full blog post here.

Key Advantages

Fast: Optimized for efficient sequence processing

The hybrid design combines Transformer attention with Mamba (a state-space model). Mamba layers are more efficient for sequence processing, while attention layers capture complex dependencies. This mix reduces memory overhead, improves throughput, and makes the model run smoothly on laptops, GPUs, and even mobile devices, while maintainig impressive quality.

<img src="https://huggingface.co/ai21labs/AI21-Jamba-Reasoning-3B-GGUF/resolve/main/assets/Intelligence%20vs%20Speed%20Jamba%20Reasoning%203B.png" width="900"/>

Smart: Leading intelligence scores

The model outperforms competitors, such as Gemma 3 4B, Llama 3.2 3B, and Granite 4.0 Micro, on a combined intelligence score that averages 6 standard benchmarks.

<img src="https://huggingface.co/ai21labs/AI21-Jamba-Reasoning-3B-GGUF/resolve/main/assets/Benchmark%20Performance%20-%20Jamba%20Reasoning%203B.png" width="900"/>

Scalable: Handles very long contexts

Unlike most compact models, Jamba Reasoning 3B supports extremely long contexts. Mamba layers allow the model to process inputs without storing massive attention caches, so it scales to 256K tokens while keeping inference practical. This makes it suitable for edge deployment as well as datacenter workloads.

<img src="https://huggingface.co/ai21labs/AI21-Jamba-Reasoning-3B-GGUF/resolve/main/assets/Speed%20vs%20Context%20Length.png" width="900"/>

Model Details

• Number of Parameters: 3B
• Number of Layers: 28 (26 Mamba, 2 Attention)
• Number of Attention Heads: 20 MQA (20 for Q, 1 for KV)
• Vocabulary Size: 64K
• Context Length: 256k
• Architecture: Hybrid Transformer–Mamba with efficient attention and long-context support
• Developed by: AI21
• Supported languages: English, Spanish, French, Portuguese, Italian, Dutch, German, Arabic and Hebrew
• Intelligence benchmark results:

Quickstart

You can run Jamba Reasoning 3B on your own machine using popular lightweight runtimes. This makes it possible to experiment with long-context reasoning without relying on cloud infrastructure.

• Supported runtimes: llama.cpp, LM Studio, and Ollama.
• Quantizations: Multiple quantization levels are provided to shrink the model size.
  • Full precision FP16 GGUF - 6.4 GB
  • 4 bit quantization using Q4-K-M GGUF - 1.93 GB

Run the model with llama.cpp

llama.cpp Python SDK

pip install llama-cpp-python
pip install huggingface_hub

from llama_cpp import Llama
from huggingface_hub import hf_hub_download

# Download from HF
model_path = hf_hub_download(
    repo_id="ai21labs/AI21-Jamba-Reasoning-3B-GGUF",  
    filename="jamba-reasoning-3b-Q4_K_M.gguf",
    token="<HF token>"
)

llm = Llama(
    model_path=model_path,
    n_ctx=128000,
    n_threads=10,        # CPU threads
    n_gpu_layers=-1,     # -1 = all layers on GPU (Metal/CUDA if available)
    flash_attn=True,
)

prompt =  """
You are analyzing a stream of customer support tickets to decide which ones require escalation.

Ticket 1: "The new update caused our app to crash whenever users upload a file larger than 50MB."
Ticket 2: "I can't log in because I forgot my password."
Ticket 3: "The billing page is missing the new enterprise pricing option."

Classify each ticket as 'Critical', 'Medium', or 'Low' priority and explain your reasoning."""
res = llm(
    prompt,
    max_tokens=8192,
    temperature=0.6,
)

print(f"\n\nResponse: {res['choices'][0]['text']}\n\n")

llama.cpp server

git clone https://github.com/ggml-org/llama.cpp
cd llama.cpp
cmake -B build
cmake --build build --config Release

Start llama.cpp server with Jamba-Reasoning-3B gguf:

./build/bin/llama-server --jinja \
--hf-repo ai21labs/AI21-Jamba-Reasoning-3B-GGUF \
--hf-file jamba-reasoning-3b-Q4_K_M.gguf \
-ngl -1 \
--host 127.0.0.1 \
--port 8000

Quick sanity test using curl:

curl --location 'http://127.0.0.1:8000/v1/chat/completions' \
--header 'Content-Type: application/json' \
--data '{
    "model": "jamba-reasoning-3b",
    "messages": [
        {
            "role": "user",
            "content": "You are analyzing customer support tickets to decide which need escalation.\nTicket 1: '\''App crashes when uploading files >50MB.'\''\nTicket 2: '\''Forgot password, can’t log in.'\''\nTicket 3: '\''Billing page missing enterprise pricing.'\''\nClassify each ticket as Critical, Medium, or Low and explain your reasoning.\n"
        }
    ],
    "max_tokens": 8192,
    "temperature": 0.6
}'

Run the model with vLLM

[!NOTE] Please reference the base model's model card here.

Training Details

We trained the model in multiple stages, each designed to strengthen reasoning and long-context performance. The process began with large-scale pre-training on a diverse corpus of natural documents. We then mid-trained on ~0.5T tokens of math and code, while extending the context length to 32K tokens. During this stage we also applied a Mamba-specific long-context method, which we found to significantly improve long-context abilities.

To improve reasoning, tool use, and instruction following, we applied cold-start distillation: supervised fine-tuning with a 32K window and direct preference optimization with a 64K window. Finally, we enhanced reasoning performance further through online reinforcement learning with RLVR, targeting tasks such as code generation, mathematical problem solving, structured output, and information extraction.

Reinforcement “Fine-Tuning”

Full support for training Jamba through VeRL will be available soon. AI21 has introduced several improvements to the VeRL framework (https://github.com/volcengine/verl), including new capabilities for training hybrid models, and stability improvements for GRPO training. These improvements will soon be available to the open source community.

---

License

• Apache 2.0

---

Citation

• Blog post- Read the full blog post here.