Instructions to use openbmb/MiniCPM4.1-8B with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use openbmb/MiniCPM4.1-8B with Transformers:

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

pipe = pipeline("text-generation", model="openbmb/MiniCPM4.1-8B", trust_remote_code=True)
messages = [
    {"role": "user", "content": "Who are you?"},
]
pipe(messages)

# pip install -U transformers accelerate
# Load model directly
from transformers import AutoModelForCausalLM
model = AutoModelForCausalLM.from_pretrained("openbmb/MiniCPM4.1-8B", trust_remote_code=True, device_map="auto")

Notebooks
Google Colab
Kaggle
Local Apps Settings

vLLM

How to use openbmb/MiniCPM4.1-8B with vLLM:

Install from pip and serve model

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

Use Docker

docker model run hf.co/openbmb/MiniCPM4.1-8B

SGLang

How to use openbmb/MiniCPM4.1-8B 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 "openbmb/MiniCPM4.1-8B" \
    --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": "openbmb/MiniCPM4.1-8B",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

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 "openbmb/MiniCPM4.1-8B" \
        --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": "openbmb/MiniCPM4.1-8B",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Docker Model Runner
How to use openbmb/MiniCPM4.1-8B with Docker Model Runner:
```
docker model run hf.co/openbmb/MiniCPM4.1-8B
```

MiniCPM4.1-8B

Commit History

Oct 26 9 days ago

07:04
Set native MiniCPM4 model type⁠

sushmanth

Verified signature
e83d94d

Oct 24, 2025

08:33
Update modeling_minicpm.py⁠

funmaker

Verified signature
3a8dfed

Oct 8, 2025

12:02
add usage for llama.cpp and ollama

xcjthu

29e0d7a

Sep 30, 2025

02:50
Merge branch 'main' of hf.co:openbmb/MiniCPM4.1-8B

xcjthu

6170bc9
02:48
update usage for sparse attention

xcjthu

8ab8cc2

Sep 16, 2025

05:52
Update README.md

beyoung

Verified signature
72c952d

Sep 12, 2025

14:30
update requirements for transformers version

xcjthu

ef9ecae

Sep 11, 2025

13:48
add \n

xcjthu

a5b27c8
13:46
add \n

xcjthu

7038d5f
13:37
update readme for better presentation

xcjthu

a27fb6b

Sep 5, 2025

14:51
update README.md

BigDong

139dc15
14:46
update README.md

BigDong

a3d59fd
11:38
update README.md

BigDong

87c6bdf
11:18
update README.md

BigDong

953d52d
11:15
update README.md

BigDong

002e8d9
10:51
update README.md

BigDong

2142ed5
10:17
update README.md

BigDong

10cd12a
09:56
minor update config.json

BigDong

5914bfe
09:53
update paper link

BigDong

7329b6e
09:47
minor update config.json

BigDong

de4aa2b
09:28
update long rope setting

BigDong

4a06b69
09:21
update readme and modeling model

BigDong

f37d55b

Sep 2, 2025

08:00
first commit

BigDong

84eb0ec
07:14
initial commit

BigDong

Verified signature
bab1e12

Commit History

Oct 26 9 days ago

Set native MiniCPM4 model type⁠

Oct 24, 2025

Update modeling_minicpm.py⁠

Oct 8, 2025

add usage for llama.cpp and ollama

Sep 30, 2025

Merge branch 'main' of hf.co:openbmb/MiniCPM4.1-8B

update usage for sparse attention

Sep 16, 2025

Update README.md

Sep 12, 2025

update requirements for transformers version

Sep 11, 2025

add \n

add \n

update readme for better presentation

Sep 5, 2025

update README.md

update README.md

update README.md

update README.md

update README.md

update README.md

update README.md

minor update config.json

update paper link

minor update config.json

update long rope setting

update readme and modeling model

Sep 2, 2025

first commit

initial commit