Instructions to use SandLogicTechnologies/MiniCPM-V-4.6-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use SandLogicTechnologies/MiniCPM-V-4.6-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="SandLogicTechnologies/MiniCPM-V-4.6-GGUF", filename="MiniCPM-V-4.6-IQ3_M.gguf", )
llm.create_chat_completion( messages = "\"cats.jpg\"" )
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use SandLogicTechnologies/MiniCPM-V-4.6-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 SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M # Run inference directly in the terminal: llama cli -hf SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M # Run inference directly in the terminal: llama cli -hf SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_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 SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M # Run inference directly in the terminal: ./llama-cli -hf SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_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 SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M
Use Docker
docker model run hf.co/SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M
- LM Studio
- Jan
- Ollama
How to use SandLogicTechnologies/MiniCPM-V-4.6-GGUF with Ollama:
ollama run hf.co/SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M
- Unsloth Studio
How to use SandLogicTechnologies/MiniCPM-V-4.6-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 SandLogicTechnologies/MiniCPM-V-4.6-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 SandLogicTechnologies/MiniCPM-V-4.6-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for SandLogicTechnologies/MiniCPM-V-4.6-GGUF to start chatting
- Pi
How to use SandLogicTechnologies/MiniCPM-V-4.6-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M
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": "SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use SandLogicTechnologies/MiniCPM-V-4.6-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 SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M
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 SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use SandLogicTechnologies/MiniCPM-V-4.6-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
- Docker Model Runner
How to use SandLogicTechnologies/MiniCPM-V-4.6-GGUF with Docker Model Runner:
docker model run hf.co/SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M
- Lemonade
How to use SandLogicTechnologies/MiniCPM-V-4.6-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull SandLogicTechnologies/MiniCPM-V-4.6-GGUF:IQ3_M
Run and chat with the model
lemonade run user.MiniCPM-V-4.6-GGUF-IQ3_M
List all available models
lemonade list
MiniCPM-V-4.6
MiniCPM-V-4.6 is a compact vision-language model developed by OpenBMB, designed for efficient multimodal understanding across images, documents, charts, diagrams, screenshots, and natural scenes. This repository contains GGUF quantized variants of the model optimized for efficient local inference using llama.cpp.
Unlike task-specific OCR or document parsing models, MiniCPM-V-4.6 is a general-purpose multimodal assistant capable of jointly understanding visual and textual information. It combines image perception, reasoning, OCR capability, document understanding, and multimodal dialogue within a compact architecture suitable for resource-efficient deployment.
The quantized formats significantly reduce memory requirements while preserving strong multimodal reasoning capability, enabling practical deployment on consumer hardware and edge AI systems.
Model Overview
- Model Name: MiniCPM-V-4.6
- Base Model: openbmb/MiniCPM-V-4.6
- Architecture: Vision-Language Model (VLM)
- Modalities: Text, Image
- Primary Languages: Multilingual
- Developer: OpenBMB
- License: Apache 2.0
Quantization Formats
This repository provides various GGUF quantized versions of the MiniCPM-V-4.6 model optimized for efficient local inference using llama.cpp.
IQ3_M
- Size reduction of approx 70.05% (432.74 MB) compared to 16-bit (1.41 GB)
- Aggressive 3-bit quantization optimized for lightweight multimodal inference on memory-constrained hardware
- Suitable for image understanding, visual question answering, OCR, and multimodal conversational workloads
- Enables efficient deployment on consumer CPUs and lower-memory GPU systems
- Fine-grained visual reasoning and complex scene interpretation may experience reduced fidelity compared to higher-precision variants
IQ4_NL
- Size reduction of approx 65.84% (493.22 MB) compared to 16-bit (1.41 GB)
- Advanced 4-bit non-linear quantization designed to better preserve multimodal reasoning and visual understanding quality
- Better suited for image analysis, document interpretation, OCR, and chart understanding workflows
- Provides improved consistency across diverse multimodal tasks while minimizing quantization loss
- May require slightly increased computational overhead during inference
IQ4_XS
- Size reduction of approx 66.61% (482.19 MB) compared to 16-bit (1.41 GB)
- Balanced 4-bit quantization optimized for efficient multimodal inference and dependable response quality
- Provides a practical balance between memory efficiency, visual understanding performance, and runtime speed
- Suitable for multimodal assistants, image reasoning, document understanding, and edge AI deployments
- Maintains stable performance across a broad range of real-world vision-language applications
Training Background (Original Model)
MiniCPM-V-4.6 is trained with an emphasis on multimodal reasoning, image understanding, OCR, document comprehension, and visual-language alignment across diverse image and text datasets.
Pretraining
- Large-scale multimodal pretraining using image-text datasets spanning natural images, documents, charts, screenshots, and diagrams
- Focus on visual-language alignment, semantic understanding, and multimodal representation learning
- Optimized for downstream multimodal reasoning and visual understanding tasks
Multimodal Optimization
- Enhanced for visual reasoning, document understanding, OCR, chart interpretation, and multimodal dialogue
- Improved performance across image analysis, visual question answering, and structured multimodal interactions
- Designed to provide strong multimodal capability while maintaining an efficient model footprint
Key Capabilities
Image Understanding Interprets natural images, scenes, screenshots, and visual content.
Visual Reasoning Performs reasoning over complex visual information and image-based tasks.
Document Understanding Understands documents, reports, tables, and structured visual layouts.
Optical Character Recognition (OCR) Extracts and interprets textual information embedded within images.
Chart & Diagram Analysis Understands charts, plots, diagrams, and other structured visual representations.
Multimodal Conversation Supports interactive conversations combining image and text inputs.
Efficient Local Deployment Quantized variants enable practical multimodal inference on consumer hardware.
Usage Example
Using llama.cpp
./llama-mtmd-cli \
-m SandLogicTechnologies/MiniCPM-V-4.6_IQ4_NL.gguf \
--mmproj SandLogicTechnologies/mmproj-minicpm-v-4.6-f16.gguf \
--image chart.png \
-p "Analyze this chart and explain the key trends."
Recommended Usecases
Vision-Language Assistants Build interactive multimodal AI assistants capable of understanding images and text.
Visual Question Answering Answer questions based on photographs, diagrams, charts, and screenshots.
Document & OCR Applications Interpret documents and extract textual information from visual content.
Chart & Diagram Interpretation Analyze graphs, plots, technical diagrams, and presentation materials.
Educational & Research Tools Support multimodal learning, tutoring, and visual content understanding.
Edge AI Deployments Deploy compact multimodal intelligence on resource-constrained hardware.
Acknowledgments
These quantized models are based on the original work by the *OpenBMB- development team.
Special thanks to:
- The OpenBMB team for developing and releasing the MiniCPM-V-4.6 model.
- Georgi Gerganov and the
llama.cppopen-source community for enabling efficient quantization and inference through the GGUF format.
Contact
For questions, feedback, or support, please reach out at support@sandlogic.com or visit https://www.sandlogic.com/
- Downloads last month
- -
3-bit
4-bit
Model tree for SandLogicTechnologies/MiniCPM-V-4.6-GGUF
Base model
openbmb/MiniCPM-V-4.6