Instructions to use kaitchup/MiniMax-M3-GGUF-MoQ with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Notebooks
Google Colab
Kaggle
Local Apps Settings

How to use kaitchup/MiniMax-M3-GGUF-MoQ 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 kaitchup/MiniMax-M3-GGUF-MoQ
# Run inference directly in the terminal:
llama cli -hf kaitchup/MiniMax-M3-GGUF-MoQ

Install from WinGet (Windows)

winget install llama.cpp
# Start a local OpenAI-compatible server with a web UI:
llama serve -hf kaitchup/MiniMax-M3-GGUF-MoQ
# Run inference directly in the terminal:
llama cli -hf kaitchup/MiniMax-M3-GGUF-MoQ

Build from source code

git clone https://github.com/ggml-org/llama.cpp.git
cd llama.cpp
cmake -B build
cmake --build build -j --target llama-app
# Start a local OpenAI-compatible server with a web UI:
./build/bin/llama serve -hf kaitchup/MiniMax-M3-GGUF-MoQ
# Run inference directly in the terminal:
./build/bin/llama cli -hf kaitchup/MiniMax-M3-GGUF-MoQ

Use Docker

docker model run hf.co/kaitchup/MiniMax-M3-GGUF-MoQ

Llama new
LM Studio
Jan
Ollama
How to use kaitchup/MiniMax-M3-GGUF-MoQ with Ollama:
```
ollama run hf.co/kaitchup/MiniMax-M3-GGUF-MoQ
```
Unsloth Desktop

How to use kaitchup/MiniMax-M3-GGUF-MoQ with Pi:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf kaitchup/MiniMax-M3-GGUF-MoQ

Configure the model in Pi

# Install Pi:
npm install -g @earendil-works/pi-coding-agent
# Add to ~/.pi/agent/models.json:
{
  "providers": {
    "llama-cpp": {
      "baseUrl": "http://localhost:8080/v1",
      "api": "openai-completions",
      "apiKey": "none",
      "models": [
        {
          "id": "kaitchup/MiniMax-M3-GGUF-MoQ"
        }
      ]
    }
  }
}

Run Pi

# Start Pi in your project directory:
pi

Docker Model Runner
How to use kaitchup/MiniMax-M3-GGUF-MoQ with Docker Model Runner:
```
docker model run hf.co/kaitchup/MiniMax-M3-GGUF-MoQ
```

Lemonade

How to use kaitchup/MiniMax-M3-GGUF-MoQ with Lemonade:

Pull the model

# Download Lemonade from https://lemonade-server.ai/
lemonade pull kaitchup/MiniMax-M3-GGUF-MoQ

Run and chat with the model

lemonade run user.MiniMax-M3-GGUF-MoQ-{{QUANT_TAG}}

List all available models

lemonade list

Hermes Agent

How to use kaitchup/MiniMax-M3-GGUF-MoQ with Hermes Agent:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf kaitchup/MiniMax-M3-GGUF-MoQ

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 kaitchup/MiniMax-M3-GGUF-MoQ

Run Hermes

hermes

Atomic Chat

OpenClaw

How to use kaitchup/MiniMax-M3-GGUF-MoQ with OpenClaw:

Start the llama.cpp server

# Install llama.cpp:
brew install llama.cpp
# Start a local OpenAI-compatible server:
llama serve -hf kaitchup/MiniMax-M3-GGUF-MoQ

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 "kaitchup/MiniMax-M3-GGUF-MoQ" \
  --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"

bnjmnmarie commited on Jun 25

Commit

71b422f

verified ·

1 Parent(s): 25f026d

Create LICENSE

Browse files

Files changed (1) hide show

LICENSE +17 -0

LICENSE ADDED Viewed

	@@ -0,0 +1,17 @@

+MINIMAX COMMUNITY LICENSE
+Copyright (c) 2026 MiniMax
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software for non-commercial purposes, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or provide copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+1. The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+2. If the Software (or any derivative works thereof) is used for any Commercial Use for your products or services:
+  1. you shall prominently display “Built with MiniMax M3” on a related website, user interface, blogpost, about page or product documentation.
+  2. you shall obtain a separate, prior written authorization from MiniMax by contacting api@minimax.io with the subject line “M3 licensing - authorization request”, if such products and services generate more than 20 million US dollars (or equivalent in other currencies) in yearly revenue; otherwise, you only need to send a one-time notice to api@minimax.io with the subject “M3 licensing — notice”.
+3. “Commercial Use” means any use of the Software or any derivative work thereof that is primarily intended for commercial advantage or monetary compensation, which includes, without limitation: (i) offering products or services to third parties for a fee, which utilize, incorporate, or rely on the Software or its derivatives, (ii) the commercial use of APIs provided by or for the Software or its derivatives, including to support or enable commercial products, services, or operations, whether in a cloud-based, hosted, or other similar environment, and (iii) the deployment or provision of the Software or its derivatives that have been subjected to post-training, fine-tuning, instruction-tuning, or any other form of modification, for any commercial purpose.
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+Appendix: Prohibited Uses
+You agree you will not use, or allow others to use, the Software or any derivatives of the Software to:
+1. Generate or disseminate content prohibited by applicable laws or regulations.
+2. Assist with, engage in or otherwise support any military purpose.
+3. Exploit, harm, or attempt to exploit or harm minors.
+4. Generate or disseminate false or misleading information with the intent to cause harm.
+5. Promote discrimination, hate speech, or harmful behavior against individuals or groups based on race or ethnic origin, religion, disability, age, nationality and national origin, veteran status, sexual orientation, gender or gender identity, caste, immigration status, or any other characteristic that is associated with systemic discrimination or marginalization.