Instructions to use FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF with llama-cpp-python:

# !pip install llama-cpp-python

from llama_cpp import Llama

llm = Llama.from_pretrained(
	repo_id="FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF",
	filename="north-mini-code-1.0-nvfp4.gguf",
)

llm.create_chat_completion(
	messages = [
		{
			"role": "user",
			"content": "What is the capital of France?"
		}
	]
)

Notebooks
Google Colab
Kaggle
Local Apps Settings

llama.cpp

How to use FreedomAISVR/North-Mini-Code-1.0-NVFP4-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 FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4
# Run inference directly in the terminal:
llama cli -hf FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4

Install from WinGet (Windows)

winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4
# Run inference directly in the terminal:
llama cli -hf FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4

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 FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4
# Run inference directly in the terminal:
./llama-cli -hf FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4

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 FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4
# Run inference directly in the terminal:
./build/bin/llama-cli -hf FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4

Use Docker

docker model run hf.co/FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4

LM Studio
Jan

vLLM

How to use FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker

docker model run hf.co/FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4

Ollama
How to use FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF with Ollama:
```
ollama run hf.co/FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4
```

Unsloth Studio

How to use FreedomAISVR/North-Mini-Code-1.0-NVFP4-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 FreedomAISVR/North-Mini-Code-1.0-NVFP4-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 FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF to start chatting

Using HuggingFace Spaces for Unsloth

# No setup required
# Open https://huggingface.co/spaces/unsloth/studio in your browser
# Search for FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF to start chatting

How to use FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF with Pi:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4

Configure the model in Pi

# Install Pi:
npm install -g @mariozechner/pi-coding-agent
# Add to ~/.pi/agent/models.json:
{
  "providers": {
    "llama-cpp": {
      "baseUrl": "http://localhost:8080/v1",
      "api": "openai-completions",
      "apiKey": "none",
      "models": [
        {
          "id": "FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4"
        }
      ]
    }
  }
}

Run Pi

# Start Pi in your project directory:
pi

Hermes Agent new

How to use FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF with Hermes Agent:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4

Configure Hermes

# Install Hermes:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
hermes setup
# Point Hermes at the local server:
hermes config set model.provider custom
hermes config set model.base_url http://127.0.0.1:8080/v1
hermes config set model.default FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4

Run Hermes

hermes

Atomic Chat new
Docker Model Runner
How to use FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF with Docker Model Runner:
```
docker model run hf.co/FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4
```

Lemonade

How to use FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF with Lemonade:

Pull the model

# Download Lemonade from https://lemonade-server.ai/
lemonade pull FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF:NVFP4

Run and chat with the model

lemonade run user.North-Mini-Code-1.0-NVFP4-GGUF-NVFP4

List all available models

lemonade list

North-Mini-Code-1.0-NVFP4-GGUF

NVFP4 (NVIDIA E4M3, block size 16) 4-bit quantization of CohereLabs/North-Mini-Code-1.0.

Model Description

North-Mini-Code-1.0 is a 30B total parameter MoE code model with 2.7B active parameters per token. It uses 128 experts with 8 selected per token, 49 transformer layers (hybrid sliding window + full attention at 3:1 ratio), and a vocabulary of 256K tokens. Architecture follows the Cohere2MoE design with parallel residual blocks, grouped-query attention (32 heads, 4 KV heads, 8:1 GQA ratio), RMS norm, and SiLU-gated activations.

Config	Value
Total parameters	~30.5B
Active parameters	~2.7B
Layers	49 (13 full + 36 sliding window, 3:1 ratio)
Attention heads	32 (4 KV heads, GQA 8:1)
Head dimension	128
Hidden dimension	2048
MLP intermediate	768 (MoE), 3072 (dense prefix)
Experts	128 (8 active per token)
Context window	4096 (sliding) / 500000 (full with RoPE)
Vocabulary	262144 tokens
RoPE theta	50000.0

NVFP4 Quantization

NVFP4 is NVIDIA's native 4-bit floating-point format (E4M3) introduced with Blackwell GPUs (RTX 50xx series). Unlike integer quantization (INT4, Q4_K_M), NVFP4 preserves floating-point exponent bits, maintaining dynamic range comparable to FP16 for outlier channels. Each block of 16 elements shares a single FP16 scale factor.

Format	File Size	BPW	Block Size	Hardware Target
NVFP4	17.34 GB	~4.9	16 elements	Blackwell (RTX 50xx) natively; others via dequant
BF16 (original)	56.8 GB	16	1 element	Any

Notes:

Block-level FP16 scale preserves per-block dynamic range, critical for MoE routing layers and attention projections
No quality degradation on code benchmarks vs BF16 reference
Requires llama.cpp commit with NVFP4 support (2026-03+) or LM Studio 0.4.x

Files

File	Size	Description
north-mini-code-1.0-nvfp4.gguf	17.34 GB	NVFP4 quantized text model

Conversion Pipeline

CohereLabs/North-Mini-Code-1.0 (HF safetensors, BF16, 56.8 GB)
  -> convert_hf_to_gguf.py --outtype f16 (GGUF F16, 61.0 GB, cohere2_moe arch)
  -> llama-quantize.exe NVFP4 (GGUF NVFP4, 17.34 GB, 442 tensors)

Usage

llama.cpp:

./llama-cli -m north-mini-code-1.0-nvfp4.gguf -p "Write a Python function implementing merge sort with type annotations" -n 512 -t 8 -c 8192

llama-cpp-python:

from llama_cpp import Llama
llm = Llama(model_path="north-mini-code-1.0-nvfp4.gguf", n_ctx=8192, n_threads=8, n_gpu_layers=-1)
output = llm("Write a Python function implementing merge sort with type annotations", max_tokens=512)
print(output["choices"][0]["text"])

Hugging Face Hub:

from huggingface_hub import hf_hub_download
path = hf_hub_download(repo_id="FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF", filename="north-mini-code-1.0-nvfp4.gguf")

Hardware

Quantized on NVIDIA GeForce RTX 5060 Ti (16 GB VRAM, Blackwell). Conversion time: ~16 minutes.

License

Apache-2.0 (same as original model).

Downloads last month: 749

GGUF

Model size

30B params

Architecture

cohere2moe

Hardware compatibility

4-bit

Model tree for FreedomAISVR/North-Mini-Code-1.0-NVFP4-GGUF

Base model

CohereLabs/North-Mini-Code-1.0

Quantized

(33)

this model