Instructions to use numind/NuExtract-2.0-4B-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use numind/NuExtract-2.0-4B-GGUF with Transformers:

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

pipe = pipeline("image-text-to-text", model="numind/NuExtract-2.0-4B-GGUF")
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 AutoModel
model = AutoModel.from_pretrained("numind/NuExtract-2.0-4B-GGUF", device_map="auto")

Notebooks
Google Colab
Kaggle
Local Apps Settings

llama.cpp

How to use numind/NuExtract-2.0-4B-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 numind/NuExtract-2.0-4B-GGUF:Q4_K_M
# Run inference directly in the terminal:
llama cli -hf numind/NuExtract-2.0-4B-GGUF:Q4_K_M

Install from WinGet (Windows)

winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf numind/NuExtract-2.0-4B-GGUF:Q4_K_M
# Run inference directly in the terminal:
llama cli -hf numind/NuExtract-2.0-4B-GGUF:Q4_K_M

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 numind/NuExtract-2.0-4B-GGUF:Q4_K_M
# Run inference directly in the terminal:
./llama-cli -hf numind/NuExtract-2.0-4B-GGUF:Q4_K_M

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 numind/NuExtract-2.0-4B-GGUF:Q4_K_M
# Run inference directly in the terminal:
./build/bin/llama-cli -hf numind/NuExtract-2.0-4B-GGUF:Q4_K_M

Use Docker

docker model run hf.co/numind/NuExtract-2.0-4B-GGUF:Q4_K_M

LM Studio
Jan

vLLM

How to use numind/NuExtract-2.0-4B-GGUF with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "numind/NuExtract-2.0-4B-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": "numind/NuExtract-2.0-4B-GGUF",
		"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/numind/NuExtract-2.0-4B-GGUF:Q4_K_M

SGLang

How to use numind/NuExtract-2.0-4B-GGUF 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 "numind/NuExtract-2.0-4B-GGUF" \
    --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": "numind/NuExtract-2.0-4B-GGUF",
		"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 "numind/NuExtract-2.0-4B-GGUF" \
        --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": "numind/NuExtract-2.0-4B-GGUF",
		"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"
						}
					}
				]
			}
		]
	}'

Ollama
How to use numind/NuExtract-2.0-4B-GGUF with Ollama:
```
ollama run hf.co/numind/NuExtract-2.0-4B-GGUF:Q4_K_M
```
Unsloth Desktop
Docker Model Runner
How to use numind/NuExtract-2.0-4B-GGUF with Docker Model Runner:
```
docker model run hf.co/numind/NuExtract-2.0-4B-GGUF:Q4_K_M
```

Lemonade

How to use numind/NuExtract-2.0-4B-GGUF with Lemonade:

Pull the model

# Download Lemonade from https://lemonade-server.ai/
lemonade pull numind/NuExtract-2.0-4B-GGUF:Q4_K_M

Run and chat with the model

lemonade run user.NuExtract-2.0-4B-GGUF-Q4_K_M

List all available models

lemonade list

Atomic Chat

Dreano commited on Sep 26, 2025

Commit

7154e13

verified ·

1 Parent(s): d3e6afe

Upload folder using huggingface_hub

Browse files

Files changed (24) hide show

.gitattributes +23 -0
NuExtract-2.0-4B-BF16.gguf +3 -0
NuExtract-2.0-4B-IQ3_M.gguf +3 -0
NuExtract-2.0-4B-IQ3_S.gguf +3 -0
NuExtract-2.0-4B-IQ3_XS.gguf +3 -0
NuExtract-2.0-4B-IQ4_NL.gguf +3 -0
NuExtract-2.0-4B-IQ4_XS.gguf +3 -0
NuExtract-2.0-4B-Q2_K.gguf +3 -0
NuExtract-2.0-4B-Q3_K_L.gguf +3 -0
NuExtract-2.0-4B-Q3_K_M.gguf +3 -0
NuExtract-2.0-4B-Q3_K_S.gguf +3 -0
NuExtract-2.0-4B-Q4_0.gguf +3 -0
NuExtract-2.0-4B-Q4_1.gguf +3 -0
NuExtract-2.0-4B-Q4_K_M.gguf +3 -0
NuExtract-2.0-4B-Q4_K_S.gguf +3 -0
NuExtract-2.0-4B-Q5_0.gguf +3 -0
NuExtract-2.0-4B-Q5_1.gguf +3 -0
NuExtract-2.0-4B-Q5_K_M.gguf +3 -0
NuExtract-2.0-4B-Q5_K_S.gguf +3 -0
NuExtract-2.0-4B-Q6_K.gguf +3 -0
NuExtract-2.0-4B-Q8_0.gguf +3 -0
NuExtract-2.0-4B-TQ1_0.gguf +3 -0
NuExtract-2.0-4B-TQ2_0.gguf +3 -0
mmproj-BF16.gguf +3 -0

.gitattributes CHANGED Viewed

@@ -34,3 +34,26 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
 nuextract2_bench.png filter=lfs diff=lfs merge=lfs -text

 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
 nuextract2_bench.png filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-BF16.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-IQ3_M.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-IQ3_S.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-IQ3_XS.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-IQ4_NL.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-IQ4_XS.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q2_K.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q3_K_L.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q3_K_M.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q3_K_S.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q4_0.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q4_1.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q4_K_M.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q4_K_S.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q5_0.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q5_1.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q5_K_M.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q5_K_S.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q6_K.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-Q8_0.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-TQ1_0.gguf filter=lfs diff=lfs merge=lfs -text
+NuExtract-2.0-4B-TQ2_0.gguf filter=lfs diff=lfs merge=lfs -text
+mmproj-BF16.gguf filter=lfs diff=lfs merge=lfs -text

NuExtract-2.0-4B-BF16.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:43aff505caca17af749a262e5447387a574db99461fa897c6e464859e906320f
+size 6178320096

NuExtract-2.0-4B-IQ3_M.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:0492ab035f25ef54d1b978e017fc329ed678f8e3ec4a9bdd0cef55ffbf3431b5
+size 1488897760

NuExtract-2.0-4B-IQ3_S.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:2dd610588d576ab07039122e984382d1e201243bbf9cfdb8e14ef688328c3195
+size 1456867040

NuExtract-2.0-4B-IQ3_XS.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:28645f81f5f6054249b141bb7e196500e822eb314727fd93c1f4064f0743fdf1
+size 1391838944

NuExtract-2.0-4B-IQ4_NL.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:cc26383c8c23a46b42b367250ab7bbe2e9ed9b6797f1d5d827d76df138730add
+size 1836484320

NuExtract-2.0-4B-IQ4_XS.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:69956ef91d77394a9b7f65af139e419b50f3b48ee9b968a8121e2c95aa3a4b87
+size 1753188064

NuExtract-2.0-4B-Q2_K.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:08e58f8c8aea143058230563e50afd2ac24bbd3ce09ce561057354299affd37e
+size 1274758880

NuExtract-2.0-4B-Q3_K_L.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:814e21ccb60939c1468b97888a7004a20b0ab0f70a85d648794f6c6822a8bb69
+size 1707394784

NuExtract-2.0-4B-Q3_K_M.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:3e3a586f79d96ef5d4878eaf5d5b46fe415ad522d0f04bd73b04f5326c84a58d
+size 1590478560

NuExtract-2.0-4B-Q3_K_S.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:fbc6f1b7608d3d9cca23a60f24e42cc00bd98a6364497aa589cfb0f5db5907f6
+size 1454360288

NuExtract-2.0-4B-Q4_0.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:f699cd4a92a8f8de231ca3e17dfb90e036056112cbd8df00857f076cc2beb0e2
+size 1822852832

NuExtract-2.0-4B-Q4_1.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:223da1be55f2ab564c5ef4103328e0faa806c7d560e0505c7ab680ea1c9ce7cd
+size 1996261088

NuExtract-2.0-4B-Q4_K_M.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:97c2a6ab9b95f24fbbf4dca5d557a0959cdd2999635bae4b0a9b944f34fe5cd4
+size 1929905888

NuExtract-2.0-4B-Q4_K_S.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:82b18827302d26df28f6a6544d4a39304b5c58cfbbc67c355022fe8e45394442
+size 1834387168

NuExtract-2.0-4B-Q5_0.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:370085d6f4dace41966b5eb8b989317996f9ef12f2ccc871a75540e55b2bcb12
+size 2169669344

NuExtract-2.0-4B-Q5_1.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:c9e9e59488ff397efc0fc7915599824729624dc90933a5b396b3aeebbefad66e
+size 2343077600

NuExtract-2.0-4B-Q5_K_M.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:0a68d20bc795bf94b304fda9429a8ed474c8cb80d7d7e1daace9ac4e4fe40711
+size 2224817888

NuExtract-2.0-4B-Q5_K_S.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:eeda16100af083790eb2ad43f28f1e1225db336583ced4f8b0689b5ee72b1c84
+size 2169669344

NuExtract-2.0-4B-Q6_K.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:4e3e288f3dae7248e3bcc239476e85973338abc33db5236cb14016650c081a64
+size 2538161888

NuExtract-2.0-4B-Q8_0.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:1f7625a2e0f2c3f85b7f25b9c9eb7482ff1c8a12d7b6b12e1f8329d01033521f
+size 3285479136

NuExtract-2.0-4B-TQ1_0.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:c682a9fe17dedc8b46634046cc64c7c79196b3239f3728e8a09498476bcbec3c
+size 847431392

NuExtract-2.0-4B-TQ2_0.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:4c9958978348cda56a1581f2d0624e9b25fadc69dc234cad2bca2592ad0b4025
+size 977487584

mmproj-BF16.gguf ADDED Viewed

	@@ -0,0 +1,3 @@

+version https://git-lfs.github.com/spec/v1
+oid sha256:221cdaa327d7dfb53cd3486e7e328a7889eacf39dd8fbf10d804e2a1d49c8acc
+size 1341438944