Instructions to use NbAiLab/borealis-27b with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use NbAiLab/borealis-27b with Transformers:

# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("image-text-to-text", model="NbAiLab/borealis-27b")
messages = [
    {
        "role": "user",
        "content": [
            {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"},
            {"type": "text", "text": "What animal is on the candy?"}
        ]
    },
]
pipe(text=messages)

# Load model directly
from transformers import AutoProcessor, AutoModelForImageTextToText

processor = AutoProcessor.from_pretrained("NbAiLab/borealis-27b")
model = AutoModelForImageTextToText.from_pretrained("NbAiLab/borealis-27b")
messages = [
    {
        "role": "user",
        "content": [
            {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"},
            {"type": "text", "text": "What animal is on the candy?"}
        ]
    },
]
inputs = processor.apply_chat_template(
	messages,
	add_generation_prompt=True,
	tokenize=True,
	return_dict=True,
	return_tensors="pt",
).to(model.device)

outputs = model.generate(**inputs, max_new_tokens=40)
print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:]))

Notebooks
Google Colab
Kaggle
Local Apps

vLLM

How to use NbAiLab/borealis-27b with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "NbAiLab/borealis-27b"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "NbAiLab/borealis-27b",
		"messages": [
			{
				"role": "user",
				"content": [
					{
						"type": "text",
						"text": "Describe this image in one sentence."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
						}
					}
				]
			}
		]
	}'

Use Docker

docker model run hf.co/NbAiLab/borealis-27b

SGLang

How to use NbAiLab/borealis-27b 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 "NbAiLab/borealis-27b" \
    --host 0.0.0.0 \
    --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "NbAiLab/borealis-27b",
		"messages": [
			{
				"role": "user",
				"content": [
					{
						"type": "text",
						"text": "Describe this image in one sentence."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
						}
					}
				]
			}
		]
	}'

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 "NbAiLab/borealis-27b" \
        --host 0.0.0.0 \
        --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "NbAiLab/borealis-27b",
		"messages": [
			{
				"role": "user",
				"content": [
					{
						"type": "text",
						"text": "Describe this image in one sentence."
					},
					{
						"type": "image_url",
						"image_url": {
							"url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg"
						}
					}
				]
			}
		]
	}'

Docker Model Runner
How to use NbAiLab/borealis-27b with Docker Model Runner:
```
docker model run hf.co/NbAiLab/borealis-27b
```
Browse Quantizations to use this model in llama.cpp, Ollama, LM Studio, or any compatible app.

You need to agree to share your contact information to access this model

This repository is publicly accessible, but you have to accept the conditions to access its files and content.

Borealis 27B

Model Summary

NbAiLab/borealis-27b is a 27B-parameter instruction-tuned full release model in the Borealis family from the National Library of Norway (Nasjonalbiblioteket, NB).

This is the first Borealis release to incorporate data made available under the agreement between rights-holder organizations in Norway and the Norwegian government. To date, only a limited subset of the material has been used, specifically to teach the model how to generate news article titles and ingress texts. Models with the suffix -open, do not include any material from the agreement.

All Borealis released models are based on the Gemma 3 family. This model is based on google/gemma-3-27b-it, and fine-tuned for Norwegian-centric instruction following.

Sizes

Size	Full release	Open release
27B	NbAiLab/borealis-27b	NbAiLab/borealis-open-27b
12B	NbAiLab/borealis-12b	NbAiLab/borealis-open-12b
4B	NbAiLab/borealis-4b	NbAiLab/borealis-open-4b
1B	NbAiLab/borealis-1b	NbAiLab/borealis-open-1b
270M	NbAiLab/borealis-270m	NbAiLab/borealis-open-270m

Training Data

Supervised fine-tuning (SFT) uses instruction data prepared by the National Library of Norway for Norwegian-centric assistant behavior, writing, summarization, question answering, and related tasks.

The SFT dataset for this model is NbAiLab/aurora-sft. NbAiLab/aurora-sft-open is the open version of the SFT dataset. The only difference between NbAiLab/aurora-sft-open and NbAiLab/aurora-sft is the addition of 10k tasks derived from copyright-protected newspapers material.

The Norwegian government has entered into an agreement, through the National Library of Norway, to access copyrighted press material via Kopinor on behalf of the Norwegian Media Businesses' Association (MBL), enabling the lawful training, development, maintenance, and public release of Norwegian language models. The agreement covers copyright-protected press publications published in Norway up to one year from the date of publication of the model, effectively creating a rolling cutoff date rather than a fixed historical cutoff. For this release, the cutoff date is January 1, 2025.

Evaluation

We evaluate Borealis with NorEval, MMLU-English, and nb-gpt-bench, our own evaluation suite, which will be published and described in an upcoming paper. Despite using only around 10k newspaper-derived tasks from the abovementioned agreement, we observe a slight performance increase in some key metrics. We hope to further increase the difference by incorporating proper pre-training on the newspaper material.

Safety and Alignment

The Borealis family of models are aligned for safety using prompt baking and weighted merging of SFT and aligned models. The goal of this process is to balance model quality, usefulness, and safer behavior.

As with all generative models, outputs can still be incorrect, biased, harmful, or inappropriate. Do not use the model for safety-critical or high-stakes applications without additional evaluation and safeguards.

Prompt Baking

To align the Borealis models, we employ prompt baking, a procedure that distills the behavior induced by a system prompt directly into the model weights using bakery. Specifically, we train a LoRA adapter to minimize the KL-divergence between two model distributions: Borealis conditioned on the system prompt, and the same base model augmented with the LoRA adapter but evaluated without the system prompt in context. This objective encourages the adapter to reproduce the behavioral effects of the prompt without requiring the prompt to be present at inference time.

To reduce degradation on downstream tasks and preserve general model utility, we merge the resulting prompt adapter into the base model using a scaling factor of 0.25, which we found to provide the best empirical trade-off.

Intended Use

Norwegian-centric assistant-style tasks, including drafting, summarization, Q&A, and light reasoning (this is not a reasoning model).
Assessment and improvement of Norwegian writing style and quality.
Evaluation of behavior and language coverage for Norwegian, Bokmål, and Nynorsk.

Usage

This repository contains the Transformers/safetensors version of the model. The examples below use NbAiLab/borealis-27b as the model id; replace it with another Borealis repo id if needed.

Transformers

Use the Gemma 3 multimodal interface. For text-only prompts, omit image content and keep only the text item in the message content list.

import torch
from transformers import AutoProcessor, Gemma3ForConditionalGeneration

model_id = "NbAiLab/borealis-27b"

processor = AutoProcessor.from_pretrained(model_id)
model = Gemma3ForConditionalGeneration.from_pretrained(
    model_id,
    device_map="auto",
    torch_dtype=torch.bfloat16,
)

messages = [
    {
        "role": "user",
        "content": [
            {"type": "text", "text": "Forklar kort hva du ser på bildet."},
            {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/cats.png"},
        ],
    }
]

inputs = processor.apply_chat_template(
    messages,
    add_generation_prompt=True,
    tokenize=True,
    return_dict=True,
    return_tensors="pt",
).to(model.device)

outputs = model.generate(**inputs, max_new_tokens=256)
new_tokens = outputs[0, inputs["input_ids"].shape[-1]:]
print(processor.decode(new_tokens, skip_special_tokens=True))

vLLM

Serve the model with vLLM's OpenAI-compatible server:

vllm serve NbAiLab/borealis-27b --served-model-name borealis-27b

Then call the local chat completions endpoint:

curl http://localhost:8000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "borealis-27b",
    "messages": [
      {
        "role": "user",
        "content": "Skriv tre korte punkter om norsk språkteknologi."
      }
    ],
    "max_tokens": 256
  }'

Large models may require tensor parallelism or reduced memory settings depending on the available GPU memory.

llama.cpp

llama.cpp uses GGUF files, not the safetensors files in this repository. When the planned GGUF companion repository is available, you can run it directly from the Hub:

llama-server -hf NbAiLab/borealis-27b-gguf --port 8080

Or download a GGUF file and run it locally:

llama-cli -m borealis-27b.gguf \
  -p "Skriv et kort sammendrag av hva Nasjonalbiblioteket gjør." \
  -n 256

Ollama

Ollama also requires a GGUF model. Once the GGUF companion repository is available, you can run it from Hugging Face:

ollama run hf.co/NbAiLab/borealis-27b-gguf

For a local GGUF file, create a minimal Modelfile:

FROM ./borealis-27b.gguf

Then create and run the local Ollama model:

ollama create borealis-27b -f Modelfile
ollama run borealis-27b "Skriv tre korte punkter om norsk språkteknologi."

Limitations

The model may hallucinate or produce incorrect information.
Safety alignment reduces but does not eliminate harmful or inappropriate outputs.
Performance outside Norwegian and English use cases has not been fully characterized.

EU AI Act

The model is a fine-tune of Gemma 3. Using Gemma 3 27B as a conservative upper-bound reference, the original Gemma 3 27B training compute is estimated at approximately 2.1-2.3 x 10^24 FLOPs, based on the disclosed 14T training-token budget and the 27B parameter scale. The fine-tuning run used approximately 3.4 x 10^20 FLOPs, or about 0.015% of the estimated original training compute. This is substantially below the European Commission's indicative one-third threshold for treating a downstream modification as a significant modification that would make the modifier the provider of the modified General Purpose AI (GPAI) model.

On that basis, the fine-tuning activity is preliminarily assessed as not constituting a substantial modification for the purpose of becoming the provider of a new modified GPAI model under the compute-based criterion. However, the resulting model remains derived from a generative general-purpose AI model and may still be subject to downstream AI-system obligations under the EU AI Act.

For additional model-level documentation, see the Model Documentation Form.

License

The license of this model is an adaptation of the Apache 2.0 license with additional use-based restrictions. In particular, users of the model are required to refrain from intentionally using the model to recreate data the model has been trained on. The license also requires users not to use the model or its output to provide end-user services whose primary purpose is to give access to licensed press publications in the training data.

For more information, see the LICENSE and the License FAQ.

Authenticity

This model release is signed by the National Library of Norway. The signed manifest in signing/SHA256SUMS covers the model-runtime artifacts, including model weights, configuration, tokenizer files, and chat template.

To verify model authenticity and file integrity after downloading the repository, run:

bash signing/verify.sh

For more verification instructions, see ai.nb.no/verify.

Weights

This repository contains the Transformers (safetensors) release of NbAiLab/borealis-27b.

Companion formats:

GGUF: NbAiLab/borealis-27b-gguf
MLX: NbAiLab/borealis-27b-mlx
MLX 8-bit: NbAiLab/borealis-27b-mlx-8bits

Citation and Contributors

The Borealis family of models is a joint effort of multiple teams at the National Library of Norway. Led by Javier de la Rosa (@versae), key contributors include (in alphabetical order) Rolv-Arild Braaten, Magnus Breder Birkenes, Lucas Charpentier, Pawel Cyrta, Tita Enstad, Markus Sverdvik Heiervang, Arne Martinus Lindstad, Marthe Løken Midtgaard, Marie Roald, Marie Røsok, Thea Tollersrud, and Angelina Zanardi. Olaus Ingskog Bergstrøm contributed with legal advice. And Yngvil Beyer, Svein Arne Brygfjeld, and Wilfred Østgulen helped with strategic oversight.

A tecnical report will be released soon.

Acknowledgements

Thanks to the Gemma team at Google for releasing Gemma 3, and to everyone contributing to the Norwegian language technology ecosystem.

Disclaimer

The models published in this repository are intended for a generalist purpose and are available to third parties. These models may have bias and/or any other undesirable distortions. When third parties, deploy or provide systems and/or services to other parties using any of these models (or using systems based on these models) or become users of the models, they should note that it is their responsibility to mitigate the risks arising from their use and, in any event, to comply with applicable regulations, including regulations regarding the use of artificial intelligence. In no event shall the owner of the models (The National Library of Norway) be liable for any results arising from the use made by third parties of these models.