Instructions to use bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental", filename="openai_gpt-oss-20b-MXFP4.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 bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental 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 bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental # Run inference directly in the terminal: llama cli -hf bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental # Run inference directly in the terminal: llama cli -hf bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental
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 bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental # Run inference directly in the terminal: ./llama-cli -hf bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental
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 bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental # Run inference directly in the terminal: ./build/bin/llama-cli -hf bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental
Use Docker
docker model run hf.co/bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental
- LM Studio
- Jan
- vLLM
How to use bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental
- Ollama
How to use bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental with Ollama:
ollama run hf.co/bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental
- Unsloth Studio
How to use bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental 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 bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental 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 bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental to start chatting
- Pi
How to use bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental
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": "bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental
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 bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental
Run Hermes
hermes
- Atomic Chat new
- Docker Model Runner
How to use bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental with Docker Model Runner:
docker model run hf.co/bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental
- Lemonade
How to use bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental
Run and chat with the model
lemonade run user.openai_gpt-oss-20b-GGUF-MXFP4-Experimental-{{QUANT_TAG}}List all available models
lemonade list
Chat template tool calling issue
when using llama.cpp (PR#15091 - https://github.com/ggml-org/llama.cpp/pull/15091), the default chat template will reject many tool calling and return HTTP500.
Tried to use the chat template from https://huggingface.co/ggml-org/gpt-oss-20b-GGUF , tool calling is much better
Same here
hitting this exception https://huggingface.co/openai/gpt-oss-20b/blob/main/chat_template.jinja#L344-L345
and getting 500 after some followup question in the chat.
My own quants are also suffering from the same issue.
Also noted the issue on the llama.cpp PR (now closed)
https://github.com/ggml-org/llama.cpp/pull/15091#issuecomment-3156310893
Same here. The Template seams to be broken throwing errors in the llama-server UI and giving weird output in the OpenAI compatible endpoint of llama-server
I am running it with the suggested PR 15091 and the inference itself is fast and smooth
llama-server --host 0.0.0.0 --port 8080 --gpu-layers 25 -hf bartowski/openai_gpt-oss-20b-GGUF-MXFP4-Experimental -c 0 -fa --jinja --reasoning-format none
yeah i also had an issue while making the template for the card so I'm not sure if we need an update to fix it or what's going on, for now it's good to know using --jinja works, but also I'm not surprised this may have a few issues, it was indicated it was a mild rush-job to get it out the door!
as long as we get to use the model though it's hard to complain much :)